Transcribe Video API
Endpoints

Get a transcription

Returns the full result once `status` is `completed`. `locked` is true when the result exceeds the account's available minutes.

GET
/transcriptions/{id}

Authorization

apiKey
AuthorizationBearer <token>

An API key from Settings → API. Send as Authorization: Bearer vtt_….

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/transcriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "status": "pending",  "locked": true,  "language": "string",  "durationSeconds": 0,  "fileName": "string",  "mediaType": "string",  "segments": [    {      "start": 0,      "end": 0,      "text": "string",      "speaker": "string"    }  ],  "audioUrl": "string",  "isPublic": true,  "error": "string",  "createdAt": "2019-08-24T14:15:22Z"}
{  "error": {    "code": "unauthorized",    "message": "string"  }}
{  "error": {    "code": "unauthorized",    "message": "string"  }}
{  "error": {    "code": "unauthorized",    "message": "string"  }}

Create a transcription POST

Submit by `storagePath` (from /uploads) or by a public `url` that we fetch directly. Returns immediately with a job id; the job runs asynchronously. Send an optional `Idempotency-Key` header so a retried call returns the same job instead of duplicating it.

Delete a transcription DELETE

Deletes the transcription; cancels and refunds it if still in progress.