Show Captions

Returns a media's captions in the specified language.
Supports multiple formats: JSON (default), SRT, VTT, and TXT.
Use file extensions (.srt, .vtt, .txt) or Accept headers to specify format.

Requires api token with one of the following permissions

Read all folder and media data

Tokens with the "Act with a team member's permissions" permission
(all:delegate_to_contact_permissions scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An expiring access token
created with the all:delegate_to_contact_permissions scope and an
authorization granting the edit-transcripts permission on this media can
also be used. For a token granted any other permission on the media the
captions are not found.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The hashed ID of the media from which captions are to be retrieved.

string
required

The 3-character ISO 639-2 language code of the captions to be retrieved (e.g., eng, fra, spa). Some languages use extended IETF subtags (e.g., zh-Hant).

Query Params
string
enum

Set to segments for time-coded caption cues or diarized_segments for speaker-turn segments in JSON responses.

Allowed:
boolean
Defaults to false

For TXT responses, set to true to group the transcript by speaker turns and include speaker labels. Ignored for other response formats.

Headers
string
required
Defaults to 2026-09
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

404

Captions not found or media not found

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain
text/vtt