---
search:
  tags:
    - Episodes
    - GET
seo:
  description: >-
    Get an episode. Reference for the GET /v1/episodes/{episode_id} endpoint in
    the Jellypod API.
sidebar:
  label: Get an episode
  badge: GET
title: Get an episode
type: openapi-operation
---
`GET /v1/episodes/{episode_id}`

**Responses**

- `200` — Episode with its progress. While \`progress.poll\_after\_seconds\` is above zero, the \`Retry-After\` header carries the same wait.
- `400` — Validation failed or malformed request.
- `401` — Missing or invalid API key.
- `403` — Authenticated, but this API key does not have access to this resource.
- `404` — Resource not found.
- `429` — Rate limit exceeded. Wait \`Retry-After\` seconds before retrying; \`RateLimit-Limit\`, \`RateLimit-Remaining\`, and \`RateLimit-Reset\` describe the window.
- `500` — Internal server error.

Response example, 200:

```json
{
  "data": {
    "audio_url": "string",
    "created_at": "string",
    "description": "string",
    "generation": {
      "completed_at": "string",
      "error_message": "string",
      "started_at": "string",
      "state": "generating",
      "skipped_sources": [
        {
          "id": "string",
          "title": "string",
          "url": "string",
          "reason": "string"
        }
      ]
    },
    "host_ids": [
      "string"
    ],
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "image_url": "string",
    "podcast_id": "4c1cb0f8-818b-4f7a-9ddb-0d1ea990b35a",
    "published_at": "string",
    "scheduled_at": "string",
    "source_ids": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "status": "draft",
    "title": "string",
    "updated_at": "string",
    "url": "string",
    "video_url": "string",
    "outputs": {
      "audio": {
        "current": true,
        "download_url": "http://example.com",
        "error": "string",
        "status": "not_requested"
      },
      "video": {
        "current": true,
        "download_url": "http://example.com",
        "error": "string",
        "status": "not_requested"
      }
    },
    "progress": {
      "error": "string",
      "needs_attention": {
        "missing_visuals": 0,
        "skipped_sources": 0,
        "unvoiced_lines": 0
      },
      "phase": "string",
      "poll_after_seconds": 0,
      "render_required": true,
      "status": "idle"
    }
  }
}
```