---
title: "List transcriptions"
method: GET
path: "/api/v1/transcriptions"
---

# List transcriptions

`GET /api/v1/transcriptions`

## Request

- Base URL: `https://podcaststotext.com`
- URL: `https://podcaststotext.com/api/v1/transcriptions`
- Auth: HTTP bearer

Newest first. Metadata only, no transcript bodies.

## Query parameters

- `limit` integer
- `status` 'processing' | 'completed' | 'failed'
- `show_id` string
- `cursor` string

## Response `200`

A page of transcriptions

- object
  - `data` object[]
    - `id` string, uuid
    - `title` string
    - `status` 'processing' | 'completed' | 'failed'
    - `duration_seconds` integer, nullable
    - `format` string
    - `source_type` string, nullable
    - `source_url` string, nullable
    - `image_url` string, nullable
    - `show_id` string, nullable
    - `created_at` string, date-time
    - `transcript_url` string, nullable: Where the stored transcript lives
    - `error` string: Why the job failed. Only present when status is "failed".
    - `preview` string: First ~500 characters. Present when the transcript is readable.
    - `text` string: Full body. Only present with ?include=text.
  - `next_cursor` string, nullable: Opaque cursor for the next page, or null on the last page. Do not parse it.
  - `next_actions` string[]

## Other responses

- `401`: Missing or invalid API key

---

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