/calls

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].

Lists calls placed with the Mixmax Dialer, newest first. By default you see your own calls; workspace admins can pass scope=workspace to list calls for every current member of their workspace (for example, to feed a conversation-intelligence integration). Calls placed by users who have been removed from the workspace, or whose Mixmax account was deleted, are not returned. A later change will keep returning calls placed in the workspace after that change ships, even once their user has left.

Each call includes user, the name and email of the Mixmax user who placed it, so you can attribute calls without a separate lookup. If Mixmax cannot look those up, the request fails with a 503 instead of returning calls without them; retry the same request after the Retry-After delay.

Only calls that were actually dialed are returned. Recording audio is not included — use GET /calls/{id}/recording with the returned _id (recording playback requires the Dialer calling feature on your workspace).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
≤ 200

Number of results per page. Values above 200 are clamped to 200.

string

Opaque cursor from a previous response to fetch the next page.

string

Opaque cursor from a previous response to fetch the previous page.

string

Comma-separated list of fields to include in each result (for example fields=_id,status,comments). Fields outside the documented Call schema are ignored. user is returned whole: user, user.name and user.email each include the full user object.

string
enum

Filter to calls whose recording media is available (true) or not (false). Any other value returns a 400.

Allowed:
string
enum

Pass workspace to list calls for the workspace's current members. Calls placed by users who have been removed from the workspace, or whose account was deleted, are not returned. Requires workspace admin access; other callers receive a 403.

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json
Psst... like working with APIs? Come join us!