Skip to main content
GET
/
v1
/
calls
curl https://api.vozagent.ai/v1/calls \
  -H "Authorization: Bearer <token>"

[
  {
    "id": "call-a1b2c3d4-e5f6-a7b8-c9d0",
    "contact_id": "c1a2b3c4-d5e6-f7a8-b9c0",
    "assistant_id": "a1b2c3d4-e5f6-a7b8",
    "call_type": "inbound",
    "call_status": "completed",
    "duration_seconds": 180,
    "call_started_at": "2024-01-15T10:30:00Z",
    "call_ended_at": "2024-01-15T10:33:00Z",
    "appointment_booked": true,
    "lead_qualification": "hot",
    "call_intent": "new_quote"
  },
  {
    "id": "call-b2c3d4e5-f6a7-b8c9-d0e1",
    "contact_id": "d2b3c4d5-e6f7-a8b9-c0d1",
    "assistant_id": "a1b2c3d4-e5f6-a7b8",
    "call_type": "outbound",
    "call_status": "completed",
    "duration_seconds": 95,
    "call_started_at": "2024-01-15T11:00:00Z",
    "call_ended_at": "2024-01-15T11:01:35Z",
    "appointment_booked": false,
    "lead_qualification": "warm"
  }
]
Retrieve your API Key from your VozAgent Dashboard.

​
Query parameters

​
limit
number
default:"50"
Maximum number of calls to return. Range: 0-100.
​
offset
number
Pagination offset.
​
status
string
Filter by status: completed, in-progress, failed.
​
contact_id
string
Filter calls by contact ID.
​
assistant_id
string
Filter calls by assistant ID.
​
call_type
string
Filter by type: inbound or outbound.

​
Response

Returns an array of call records with summary information.
​
id
string
Unique call identifier.
​
contact_id
string
Associated contact ID.
​
assistant_id
string
Assistant that handled the call.
​
call_type
string
inbound or outbound.
​
call_status
string
Current status of the call.
​
duration_seconds
number
Call duration in seconds.
​
appointment_booked
boolean
Whether an appointment was booked.
​
lead_qualification
string
Lead score: hot, warm, or cold.
curl https://api.vozagent.ai/v1/calls \
  -H "Authorization: Bearer <token>"

[
  {
    "id": "call-a1b2c3d4-e5f6-a7b8-c9d0",
    "contact_id": "c1a2b3c4-d5e6-f7a8-b9c0",
    "assistant_id": "a1b2c3d4-e5f6-a7b8",
    "call_type": "inbound",
    "call_status": "completed",
    "duration_seconds": 180,
    "call_started_at": "2024-01-15T10:30:00Z",
    "call_ended_at": "2024-01-15T10:33:00Z",
    "appointment_booked": true,
    "lead_qualification": "hot",
    "call_intent": "new_quote"
  },
  {
    "id": "call-b2c3d4e5-f6a7-b8c9-d0e1",
    "contact_id": "d2b3c4d5-e6f7-a8b9-c0d1",
    "assistant_id": "a1b2c3d4-e5f6-a7b8",
    "call_type": "outbound",
    "call_status": "completed",
    "duration_seconds": 95,
    "call_started_at": "2024-01-15T11:00:00Z",
    "call_ended_at": "2024-01-15T11:01:35Z",
    "appointment_booked": false,
    "lead_qualification": "warm"
  }
]