Voice Agents
List calls
Every call the agent handled — web, phone, and WebSocket — most recently started first. Calls that were reserved but never connected are excluded.
Authorization
personalAccessToken AuthorizationBearer <token>
Personal Access Token of a Dynamiq user — the only credential accepted by the management API (api.*). Prefix dyn_pat_ (legacy uak_ tokens still authenticate). Send as Authorization: Bearer <token>.
In: header
Path Parameters
agent_id*string
Voice agent UUID.
Query Parameters
status?string
Filter by call status.
started_at:gte?string
Only calls started at or after this time (RFC 3339).
started_at:lte?string
Only calls started at or before this time (RFC 3339).
page?integer
Page number (1-based).
page_size?integer
Number of items per page. Values below the minimum or above the maximum are clamped to the nearest bound.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agents/voice/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/calls"{
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"status": "pending",
"kind": "web",
"direction": "inbound",
"caller_number": "string",
"started_at": "2019-08-24T14:15:22Z",
"ended_at": "2019-08-24T14:15:22Z",
"duration_ms": 0,
"ended_reason": "string",
"recording_status": "disabled",
"created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
"metrics_summary": {
"latency_ms_p50": 0,
"interruption_count": 0,
"turn_count": 0
}
}
],
"pagination": {
"page": 0,
"page_size": 0,
"page_count": 0,
"total_count": 0
}
}{
"error": {
"code": "bad_request",
"message": "Bad Request",
"details": {
"input": "cannot be blank"
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized"
}
}{
"error": {
"code": "not_found",
"message": "Not Found"
}
}