SIsimplified
transcription

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

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.

get/api/v1/transcription/{id}

Request

  • Base URL
    https://api.simplified.com
  • Auth
    API key in header Authorization

Path parameters

idstring required

Transcription UUID returned from transcribeVideo.

Response

Transcription record.

idstring

Transcription UUID. Use this with getTranscription and downloadTranscriptionFile.

titlestring
creatorinteger

Creator user ID.

video_urlstring

Source media URL submitted for transcription.

transcribed_video_urlstring nullable

URL of the captioned/burned-in video, if produced.

transcription_urlstring nullable

URL of the raw transcript artifact in storage.

payloadobject

Transcription payload. When job_status=COMPLETED, contains language_code and phrases (each with speaker, text, and words[{text, start, end, confidence}] in milliseconds).

contentobject

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.

statusstring

Project status (PUBLIC, PRIVATE, ARCHIVED).

project_typestring

Always "transcription" for this resource.

createdstring date-time
modifiedstring date-time
translation_languagestring nullable
provider'GGL' | 'AWS' | 'MS' | 'OAI' | 'AAI'

STT engine used for the job.

Changes

No recorded changes to this operation across all 1 revision of this API.