---
title: "An episode: status, and its found clips once ready"
method: GET
path: "/episodes/{id}"
tags: ["Episodes"]
---

# An episode: status, and its found clips once ready

`GET /episodes/{id}`

## Request

- Base URL: `https://tryslicemedia.com/api/v1`
- URL: `https://tryslicemedia.com/api/v1/episodes/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- Episode
  - `episode_id` string
  - `name` string
  - `status` 'waiting_for_upload' | 'uploading' | 'transcribing' | 'finding_clips' | 'ready' | 'failed'
  - `progress_percent` number
  - `duration` string
  - `upload_url` string
  - `clips` FoundClip[]
    - `number` integer
    - `ref` string
    - `title` string
    - `hook` string
    - `start` string
    - `end` string
    - `length` string
    - `pieces` integer
    - `cut_status` 'not_cut' | 'cutting' | 'cut' | 'failed'
    - `clip_id` string
    - `poster_url` string
    - `export_status` 'none' | 'rendering' | 'completed' | 'failed'
    - `job_id` string
    - `download_url` string
    - `about` string
    - `reason` string
  - `message` string
  - `livemode` boolean

## Other responses

- `401`: Missing, unknown, revoked or expired key.
- `403`: The key lacks the permission (scope) this needs, or the account is under billing review.
- `404`: Not on this account.
- `429`: Rate limited. See retry_after and the RateLimit-* headers.

---

[API](https://skmtc.dev/tryslicemedia/apis/slice-api.md) · [All operations](https://skmtc.dev/tryslicemedia/apis/slice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tryslicemedia/apis/slice-api/revisions/3dc0b0bd8755?raw)