Skip to main content

Download call recordings

GET 
/api/v1/calls/recording/:callid

Retrieves a single call recording file by its Call ID.

⚠️ Important: this endpoint is a fallback mechanism designed for recovering missing recordings when a delivery webhook failed or its short-lived URL expired. For production workflows, always use Call Recording Webhooks instead of polling this API.

The Call ID is all you need — the recording is searched for across the whole period your account retains recordings, so a client that stored only the Call ID can download the file.

Rate limits & quotas​

To prevent system overload, strict limits are enforced per user:

  • Request frequency: max 1 request per second.
  • Recording lookups: max 1 lookup per minute.

The per-minute quota is consumed by every search query, regardless of whether a recording is found or the request returns 404 Not Found — searching for the file is the operation that costs resources.

Authentication​

Requires a Bearer token in the Authorization header: Authorization: Bearer <token>

Request​

Responses​

Redirects to a short-lived AWS S3 pre-signed URL for the recording (.mp3). Follow the redirect — for example with curl -L — to download the file.