Calls

List calls with filters

GET
/api/calls/history

Returns a paginated list of calls for the authenticated user's organization. Filterable by contactId, userId, and status. Results are sorted by createdAt descending with contactId and userId populated. userId is the person who placed or took the call; AI calls nobody placed (inbound AI calls, workflow-placed AI calls) have no userId, and createdBy names the AI agent instead. For ElevenLabs recordings stored in R2, signed playback URLs are generated inline.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

contactId?string

Filter by contact ObjectId.

userId?string

Filter by user ObjectId.

status?string

Filter by call status (e.g. completed, no-answer, failed).

limit?string

Page size as a string (parsed to int; default 50).

offset?string

Skip count as a string (parsed to int; default 0).

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/calls/history"
{  "success": true,  "calls": [],  "total": 0}