View call history and initiate outbound calls.Endpoints#
List Calls#
Retrieve call history with optional filtering by status and date range.Query Parameters#
| Name | Type | Default | Description |
|---|
limit | integer | 100 | Max results (max 1000) |
offset | integer | 0 | Results to skip |
status | string | - | Filter: connecting, in-progress, ended, failed |
start_date | datetime | - | Filter calls from this date (ISO 8601) |
end_date | datetime | - | Filter calls until this date (ISO 8601) |
Request#
Response#
{
"calls": [
{
"id": "call-_+31612345678_abc123",
"caller_phone": "+31612345678",
"assistant_phone": "+31850835037",
"status": "ended",
"error": null,
"started_at": "2025-12-13T10:00:00.000Z",
"ended_at": "2025-12-13T10:01:24.000Z",
"duration_seconds": 84,
"summary": "Klant vroeg naar openingstijden en wilde een afspraak maken.",
"agent_name": "Customer Support",
"business_name": "Acme Corp",
"created_at": "2025-12-13T09:59:55.000Z",
"updated_at": "2025-12-13T10:01:24.000Z"
}
],
"pagination": {
"total": 150,
"limit": 50,
"offset": 0
}
}
Call Status Values#
| Status | Description |
|---|
connecting | Call is being connected |
in-progress | Call is active |
ended | Call ended normally |
failed | Call failed (see error field) |
Initiate Outbound Call#
Make your AI agent call someone.Request Body#
| Field | Type | Required | Description |
|---|
destination | string | Yes | Phone number in E.164 format |
agent_id | UUID | Yes | Agent to use for the call |
first_message | string | No | Custom greeting (overrides agent default) |
context | string | No | Additional context for the agent |
Example Request#
Response#
{
"success": true,
"call_id": "call-outbound-abc123",
"room_name": "outbound-abc12345",
"status": "dialing"
}
Use Cases#
Errors#
| Status | Description |
|---|
| 400 | Invalid destination format or inactive agent |
| 404 | Agent not found |
Modified at 2025-12-29 14:18:25
