---
title: "Get all episodes for automated podcast management"
method: GET
path: "/podcast/shows/{podcastId}/episodes"
tags: ["Podcast"]
---

# Get all episodes for automated podcast management

`GET /podcast/shows/{podcastId}/episodes`

Retrieves all episodes for a specific podcast show.
Each episode includes an array of podcast show IDs it belongs to (including the specified one and any others).
Useful for monitoring automated podcast publishing and episode management.
Supports optional pagination.

## Path parameters

- `podcastId` string, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

List of episodes with platform-ready metadata and associated podcast show IDs

- union
  - object[] — Non-paginated response (when page and limit are not provided)
    - `id` integer — Unique identifier for the episode
    - `podcastId` string — ID of the podcast show this episode belongs to
    - `requestId` string — ID of the client request that created the source audio content
    - `title` string — Episode title (displayed on podcast platforms)
    - `description` string — Episode description (displayed on podcast platforms)
    - `audioTitle` string — Original title from the generated audio content
    - `audioUrl` string — Direct URL to the episode audio file (MP3 format for platform compatibility)
    - `requestedOn` string, date-time — When the episode was requested/created
    - `succeededOn` string, date-time — When the episode processing completed successfully
    - `scheduledOn` string, date-time — When the episode is scheduled to be published (if scheduled)
    - `fileSize` integer — Audio file size in bytes (required for RSS enclosure tag)
    - `durationSeconds` integer — Episode duration in seconds (displayed on podcast platforms)
    - `podcastShowIds` string[] — Array of podcast show IDs this episode belongs to
  - object — Paginated response (when page or limit are provided)
    - `episodes` object[]
      - `id` integer — Unique identifier for the episode
      - `podcastId` string — ID of the podcast show this episode belongs to
      - `requestId` string — ID of the client request that created the source audio content
      - `title` string — Episode title (displayed on podcast platforms)
      - `description` string — Episode description (displayed on podcast platforms)
      - `audioTitle` string — Original title from the generated audio content
      - `audioUrl` string — Direct URL to the episode audio file (MP3 format for platform compatibility)
      - `requestedOn` string, date-time — When the episode was requested/created
      - `succeededOn` string, date-time — When the episode processing completed successfully
      - `scheduledOn` string, date-time — When the episode is scheduled to be published (if scheduled)
      - `fileSize` integer — Audio file size in bytes (required for RSS enclosure tag)
      - `durationSeconds` integer — Episode duration in seconds (displayed on podcast platforms)
      - `podcastShowIds` string[] — Array of podcast show IDs this episode belongs to
    - `totalCount` integer — Total number of episodes for this podcast show
    - `page` integer — Current page number
    - `pageSize` integer — Number of items per page
    - `totalPages` integer — Total number of pages

## Other responses

- `400` — Bad request - Invalid podcast ID
- `401` — Unauthorized - valid API token required
- `500` — Internal server error

---

[API](https://skmtc.net/autocontentapi/apis/content-api.md) · [All operations](https://skmtc.net/autocontentapi/apis/content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/autocontentapi/content-api/revisions/355890b6b4cc/schema)