Docs
Callsv4

Get a call recording

GET/calls/{callId}/recording

The recording of a call with is_recorded, once it's saved shortly after the call ends (call.recording.ready fires then). A ready recording carries download_url, an MP3 link that works for 10 minutes; read the recording again for a new one. Recordings are kept for the organization's retention period, at most a year. OAuth apps need calls:read.

Path parameters

callIdRequiredstring

Call id (call_...).

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

dataoptionalCallRecording
call_idRequiredstring

The recorded call (call_...).

statusRequiredstring

ready to play or download, failed when the call couldn't be recorded, deleted once deleted or past the organization's retention period.

"ready""failed""deleted"
started_atRequiredinteger | null

Epoch ms.

ended_atRequiredinteger | null

Epoch ms.

duration_msRequiredinteger | null
errorRequiredobject | null
object
codeRequiredstring
messageRequiredstring
null
download_urloptionalstring | null

MP3, dual channel (one side of the call per channel), valid for 10 minutes. Only GET returns it, and only for a ready recording.

Response codes

200The recording
400`invalid_call_id`: the id is not a `call_...` id.
401Your API key is missing or invalid. Pass it as a bearer token.
404`recording_not_found`: the call wasn't recorded, or its recording isn't saved yet.
422`recording_unavailable`: the carrier couldn't produce the recording.
502`upstream_unavailable`: the carrier network couldn't be reached. Retry with backoff.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X GET https://api.blooio.com/v4/calls/obj_a1b2c3d4/recording \
Response objectexample
{  "data": {    "call_id": "obj_a1b2c3d4",    "status": "ready",    "started_at": 0,    "ended_at": 0,    "duration_ms": 1200,    "error": {      "code": "string",      "message": "Hello from Blooio!"    },    "download_url": "https://example.com"  }}