---
title: "Get unallocated podcast episodes for user"
method: GET
path: "/podcast/episodes/unallocated"
tags: ["Podcast"]
---

# Get unallocated podcast episodes for user

`GET /podcast/episodes/unallocated`

Retrieves generated audio episodes that are not assigned to any podcast show.
This is the preferred paginated endpoint for the `/podcasts/shows/unallocated` app screen.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Paginated list of unallocated podcast episodes.

- object
  - `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[] — Always empty for unallocated episodes.
  - `totalCount` integer — Total number of unallocated episodes.
  - `page` integer — Current page number.
  - `pageSize` integer — Number of items per page.
  - `totalPages` integer — Total number of pages.
  - `draftEpisodes` object[] — Always empty for this endpoint.

## Other responses

- `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)
