Get a transcription

Poll the job-specific URL after creation. Completed jobs include transcript text and timestamped segments; failed jobs include a failure message.

GET/api/v1/transcriptions/{id}200 OK

Use this endpoint OpenAPI spec

Authentication

Send an active Fast Transcriber API key as an HTTP bearer token.

Authorization: Bearer ft_live_replace_me

Request

Use the path or query parameters described below.

Field	Type	Description
`id`required	uuid	Path parameter returned by create-transcription.

curl https://fast-transcriber.com/api/v1/transcriptions/95c3fdd8-1234-4abc-9def-0123456789ab \
  --header "Authorization: Bearer $FAST_TRANSCRIBER_API_TOKEN"

Response

Successful JSON responses use a top-level data envelope. A 204 response has no body.

Field	Type	Description
`data.id`	uuid	Job identifier.
`data.status`	string	processing, completed, or failed.
`data.text`	string \| null	Full text when completed; otherwise null.
`data.segments`	array \| null	Timestamped segments when completed and available.
`data.segments[].start`	number	Segment start offset in seconds.
`data.segments[].end`	number	Segment end offset in seconds.
`data.segments[].text`	string	Text spoken during the segment.
`data.segments[].speaker`	number \| string	Optional raw speaker identifier when diarization is enabled and available.
`data.duration_seconds`	number \| null	Detected media duration.
`data.error`	string \| null	Failure detail when status is failed.
`data.filename`	string	Source label or filename.
`data.created_at`	date-time	UTC creation timestamp.

{
  "data": {
    "created_at": "2026-09-03T10:12:00.000Z",
    "duration_seconds": 1842,
    "error": null,
    "filename": "interview.mp3",
    "id": "95c3fdd8-…",
    "segments": [
      { "start": 0, "end": 4.2, "text": "Welcome to the interview." }
    ],
    "status": "completed",
    "text": "Welcome to the interview."
  }
}

Errors

API errors return a machine-readable code and message.

Status	Code	Meaning
401	`missing_api_key`	No bearer key was supplied.
401	`invalid_api_key`	The bearer key is malformed, unknown, or revoked.
404	`not_found`	The job does not exist or belongs to a different API account.

{
  "error": {
    "code": "not_found",
    "message": "Transcription not found."
  }
}

Implementation notes

Use bounded polling with backoff; stop when status is completed or failed.