---
title: "Get one transcription"
method: GET
path: "/api/v1/transcriptions/{id}"
---

# Get one transcription

`GET /api/v1/transcriptions/{id}`

## Request

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

Poll this after creating a job. Returns a preview by default; ?include=text for the whole body, ?format= for a subtitle or text file.

## Path parameters

- `id` string, required

## Query parameters

- `include` 'text'
- `format` 'srt' | 'vtt' | 'txt' | 'md' | 'json' | 'docx' | 'pdf'
- `speakers` boolean
- `timestamps` boolean

## Response `200`

The transcription

- 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.

## Other responses

- `400`: Unknown format, or a time-coded format asked of a transcript with no timings
- `401`: Missing or invalid API key
- `404`: No such transcription on this account

---

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