EndpointsCalls

Get call recording

Get a time-limited playback URL for a call recording.

Authentication: Supports API key and bearer token authentication.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

call_idstringRequiredformat: "uuid"

Headers

X-Organization-IDstring or nullOptional

Response

Successful Response
call_idstringformat: "^call_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
ID of the call this recording belongs to
urlstring

Time-limited URL for streaming the recording

content_typestring

MIME type (audio/mp4 or video/mp4)

expires_atdatetime
When the playback URL expires
recording_statusstring
Current recording status
duration_secondsdouble or null
Recording duration in seconds
file_size_bytesinteger or null
File size in bytes
recording_start_timedatetime or null
When the recording started
is_placeholderbooleanDefaults to false

True when the recording row is a demo placeholder (no real audio behind url). Tells the FE to suppress the audio-element error banner if playback fails.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error