---
title: "Media · Transcription · Poll a transcription job for status and transcript (step 2 of 3)"
method: GET
path: "/api/v1/transcription/{id}"
tags: ["transcription"]
---

# Media · Transcription · Poll a transcription job for status and transcript (step 2 of 3)

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

## Request

- Base URL: `https://api.simplified.com`
- URL: `https://api.simplified.com/api/v1/transcription/{id}`
- Auth: API key in header `Authorization`

Step 2 — poll this endpoint with the `id` returned by `transcribeVideo`.

Read `job_status`:
- **Non-terminal** (`CREATED`, `PENDING`, `PROCESSING`, `RENDERING`,
  `UPDATED`): keep polling. A 10s interval is reasonable.
- **Terminal**: `DONE` (success — `payload.phrases` is now populated
  with word-level timing) or `FAILED` (error — stop polling).

Once `job_status="DONE"` you can either read `payload.phrases`
directly, or call `downloadTranscriptionFile` for a VTT/SRT file.

## Path parameters

- `id` string, required

## Response `200`

Transcription record.

- TranscriptionResponse
  - `id` string: Transcription UUID. Use this with getTranscription and downloadTranscriptionFile.
  - `title` string
  - `creator` integer: Creator user ID.
  - `video_url` string: Source media URL submitted for transcription.
  - `transcribed_video_url` string, nullable: URL of the captioned/burned-in video, if produced.
  - `transcription_url` string, nullable: URL of the raw transcript artifact in storage.
  - `payload` object: Transcription payload. When job_status=COMPLETED, contains `language_code` and `phrases` (each with `speaker`, `text`, and `words[{text, start, end, confidence}]` in milliseconds).
  - `content` object: Source metadata (e.g. `{source, source_id}`).
  - `job_status` 'CREATED' | 'PENDING' | 'PROCESSING' | 'DONE' | 'FAILED' | 'RENDERING' | 'UPDATED': Lifecycle state of the transcription job. Terminal: `DONE` (success) and `FAILED`. All other values are non-terminal — keep polling.
  - `status` string: Project status (PUBLIC, PRIVATE, ARCHIVED).
  - `project_type` string: Always "transcription" for this resource.
  - `created` string, date-time
  - `modified` string, date-time
  - `translation_language` string, nullable
  - `provider` 'GGL' | 'AWS' | 'MS' | 'OAI' | 'AAI': STT engine used for the job.

---

[API](https://skmtc.dev/simplified/apis/audio.md) - [All operations](https://skmtc.dev/simplified/apis/audio/llms.txt) - [OpenAPI document](https://skmtc.dev/simplified/apis/audio/revisions/55da4333efde?raw)