TranscriptionDto

A transcription job as seen by an API client. The raw internal info map and the persistence version are intentionally not exposed.

idstring

The transcription id

Example: 7Hb2Kp9QvL3mNx0R8tZ4

podcast_idstring

The parent podcast id

Example: 9aF3kQ2pVx0LmNb7Rt84

statusstring

Status of the transcription job

Possible values: [pending, processing, completed, failed]

Example: completed

filenamestring

Original audio filename

Example: episode-42.mp3

textstringnullable

Full plain-text transcript, when available.

Example: Welcome back to the show. Today we are talking about...

segments object[]

Diarized speaker segments of the transcript, in chronological order.

Array [

speakerstring

Diarized speaker label for this segment.

Example: speaker_0

textstring

Transcribed text spoken in this segment.

Example: This episode is brought to you by Acme...

startdoublenullable

Start time of the segment, in seconds from the beginning of the audio.

Example: 0

enddoublenullable

End time of the segment, in seconds from the beginning of the audio.

Example: 4.2

]

languagestringnullable

Detected language, as a language code, when available.

Example: en

durationdoublenullable

Total duration of the audio, in seconds, when available.

Example: 182.5

errorstringnullable

Error message if the transcription failed.

Example: audio file could not be decoded

created_bystringnullable

The user who initiated the transcription.

Example: user@example.com

created_atdate-time

When the transcription was created

Example: 2026-01-15T09:30:00Z

updated_atdate-time

When the transcription was last updated

Example: 2026-01-15T09:30:00Z

TranscriptionDto

{
  "id": "7Hb2Kp9QvL3mNx0R8tZ4",
  "podcast_id": "9aF3kQ2pVx0LmNb7Rt84",
  "status": "completed",
  "filename": "episode-42.mp3",
  "text": "Welcome back to the show. Today we are talking about...",
  "segments": [
    {
      "speaker": "speaker_0",
      "text": "This episode is brought to you by Acme...",
      "start": 0,
      "end": 4.2
    }
  ],
  "language": "en",
  "duration": 182.5,
  "error": "audio file could not be decoded",
  "created_by": "user@example.com",
  "created_at": "2026-01-15T09:30:00Z",
  "updated_at": "2026-01-15T09:30:00Z"
}