Skip to main content

GET Podcast Audios

Overview


The following table contains important information about the GET method in regards to receiving podcast audios for the player configuration.

GET Podcast Audios
MethodGET
URL or Endpoint/podcast/podcastId
HeadersNot Applicable
ParameterspodcastId
BodyNot Applicable

The description of the URL parameter is as follows:

podcastId URL Parameter
URL Parameter NamepodcastId
MandatoryYes
Typestring
DescriptionUnique Id of the podcast.

Request Body

The request does not contain a request body

Response

{
"podcastId": "{podcastId}",
"title": "{title}",
"audios": [
{
"mediaId": "{mediaId}",
"title": "{title}",
"author": "{author}",
"publishDate": "2026-03-27T12:00:00.000Z",
"thumbnailUrl": "{thumbnailUrl}",
"duration": 224.664,
"durationString": "{durationString}",
"hlsUrl": "{hlsUrl}"
}
]
}

Information about the fields that appear when you receive the response are displayed in the table below.

Field NameTypeDescription
podcastIdstringThe unique Id of the podcast.
titlestringThe title of the podcast.
audiosarray[object]Array of audio episodes in the podcast.
mediaIdstringThe unique Id of the audio episode.
titlestringThe title of the audio episode.
authorstringThe author of the audio episode.
publishDatestring($date-time)The publish date of the audio episode.
thumbnailUrlstringURL of the audio episode thumbnail.
durationnumberDuration of the audio episode in seconds.
durationStringstringHuman-readable duration of the audio episode.
hlsUrlstringThe HLS stream URL for the audio episode.

If the action is successful, the service sends back an HTTP 200 or 201 response.

Errors

For information about the errors that are common to all actions, see Common Errors:

  • HTTP Status Code 400: Bad Request

  • HTTP Status Code 401: Unauthorized

  • HTTP Status Code 403: Forbidden

  • HTTP Status Code 404: Result Not Found

  • HTTP Status Code 500: Internal Server Error

  • HTTP Status Code 503: Backend Fetch Failed