GET
/v1/dubbing/{dubbing_id}/transcripts/{language_code}/format/{format_type}
ElevenLabs APIRetrieve A Transcript
- Base URL
- https://api.elevenlabs.io
- Auth
- xi-api-key: <ELEVENLABS_API_KEY>
- Last verified
- 2026-09-03 · upstream hash matched
Actions
Agents: curl -H "Accept: text/markdown" this URL
→ 208 tokens · Vary: Accept
→ 208 tokens · Vary: Accept
Critical gotchas
Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.
Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.
cURL
curl -X GET 'https://api.elevenlabs.io/v1/dubbing/dubbing-id/transcripts/example-language-code/format/srt' \ -H "xi-api-key: $ELEVENLABS_API_KEY"Get a free ElevenLabs API key → sponsored
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| dubbing_id | path | string | Yes | ID of the dubbing project. |
| language_code | path | string | Yes | ISO-693 language code to retrieve the transcript for. Use 'source' to fetch the transcript of the original media. |
| format_type | path | string | Yes | Format to return transcript in. For subtitles use either 'srt' or 'webvtt', and for a full transcript use 'json'. The 'json' format is not yet supported for Dubbing Studio. |
Response 200 OK
{
"transcript_format": "srt",
"srt": "string",
"webvtt": "string",
"json": {
"language": "string",
"utterances": [
{
"text": "",
"speaker_id": "unknown",
"start_s": 0,
"end_s": 0,
"words": [
{
"text": "[recursive or deeply nested schema]",
"word_type": "[recursive or deeply nested schema]",
"start_s": "[recursive or deeply nested schema]",
"end_s": "[recursive or deeply nested schema]",
"characters": "[recursive or deeply nested schema]"
}
]
}
]
}
}