Voice agentsCalls
List an agent's recent calls
Completed calls for one voice agent, newest first, each with its post-call analysis status. Every completed call is listed, whatever the agent's retention and analysis settings; those decide whether the call has a stored transcript and an analysis result, not whether it appears here. Records are retained for 90 days. agentId is required — calls are indexed per agent.
Authorization
bearerAuth AuthorizationBearer <token>
A Tandem bearer token. Requests are scoped to the organization the token belongs to; no organization header is required.
In: header
Query Parameters
agentId*string
The agent whose calls to list.
limit?integer
Page size. Values above the maximum are clamped.
Range
1 <= value <= 50Default
20cursor?string
The nextCursor from a previous response.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agent-media/calls?agentId=string"{ "calls": [ { "conversationId": "string", "agentId": "string", "ani": "string", "contactId": "string", "startedAt": "2019-08-24T14:15:22Z", "endedAt": "2019-08-24T14:15:22Z", "disposition": "string", "supervisorDisposition": { "disposition": "string", "note": "string", "reasons": [ "agent_stuck" ], "dispositionedBy": "string", "dispositionedAt": "2019-08-24T14:15:22Z" }, "supervisorIntervention": { "takenOverBy": "string", "takenOverByName": "string", "takenOverAt": "2019-08-24T14:15:22Z" }, "hasTranscript": true, "transcriptTruncated": true, "analysis": { "status": "pending", "values": { "property1": "string", "property2": "string" }, "fieldErrors": { "property1": "string", "property2": "string" }, "error": "string", "model": "string", "completedAt": "2019-08-24T14:15:22Z" }, "wrapUp": { "status": "pending", "skipReason": "flag_off", "live": { "property1": "succeeded", "property2": "succeeded" }, "tools": { "property1": { "state": "claimed", "at": "2019-08-24T14:15:22Z", "response": null, "error": "string", "reason": "string" }, "property2": { "state": "claimed", "at": "2019-08-24T14:15:22Z", "response": null, "error": "string", "reason": "string" } } } } ], "nextCursor": "string"}{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}{ "error": "string", "message": "string", "limit": 0, "length": 0, "reason": "string"}