/calls/:id/recording [beta]

get

https://api.mixmax.com/v1/calls/{id}/recording

Limited beta. The Calls read API is currently gated by an access allowlist; callers without access receive 404 responses. To request access, email [email protected].

Streams a completed call's recording as MP3 audio. Requires the Dialer calling feature on your workspace. Managed API keys require the calls:read permission. Mixmax authenticates to the telephony provider and streams the bytes back; there is no durable, shareable media URL.

Byte-range (Range) requests are not supported: the response is always the complete file, with 200 OK and Accept-Ranges: none. Download it once and seek in your local copy. Responses are private to the caller and must not be cached.

This endpoint has its own rate limit of 20 requests per minute per user, in addition to the API-wide limit.

To learn when a new recording is ready without polling, register the call:recording-available webhook (see Webhooks in this reference). Its recordingUrl points to this endpoint.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

Credentials

Header

Loading…

Response

Choose an example:

audio/mpeg

application/json

text/html

200The complete recording audio. A Range header is ignored.

403Returned in three cases: scope=workspace was requested without workspace admin access (JSON body), a managed API key was used without the calls:read permission or outside the workspace it was made in (JSON body), or the workspace does not have the Dialer calling feature (empty body).

404The call does not exist, has no recording, the recording is no longer available, or the caller does not have access to the Calls API beta.

409The recording exists but cannot be retrieved (for example, it is encrypted).

429Too many recording requests. Honor the Retry-After response header when present. The per-endpoint limiter responds with a short plain string served as text/html; the telephony provider's passed-through throttle responds with JSON.

502The recording could not be retrieved from the telephony provider.