Calls
List calls with filters
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}