API referenceProjects

Export subtitles

The project's spoken words as a subtitle sidecar (SubRip or WebVTT), timed from the voiceover and chunked by the same caption plan the burned-in captions use.

Needs no render and costs no credits. Returns 422 until the voiceover has been generated.

GET
/projects/{id}/exports/subtitles

Authorization

bearerAuth
AuthorizationBearer <token>

Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….

In: header

Path Parameters

id*string
Formatuuid

Query Parameters

format?string

Output format (default srt).

Value in"srt" | "vtt"
download?string

Return the raw file with a Content-Disposition attachment header instead of the JSON envelope.

Value in"1" | "true"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/exports/subtitles"
{
  "filename": "how-engines-work.srt",
  "contentType": "application/x-subrip; charset=utf-8",
  "content": "string"
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}