GET /calls — List call history

This endpoint returns a paginated list of calls from your workspace history, ordered by creation date descending. You can filter results by call status or type to narrow down the records you need. For full details on a single call — including the transcript and analysis data — use the Get call endpoint.

Endpoint

GET https://api.verbeo.ai/calls

Query parameters

number

default:"50"

Maximum number of calls to return. The maximum allowed value is 100.

number

default:"0"

Number of records to skip before returning results. Use this with limit to paginate through large result sets.

string

Filter by call status. Accepted values: queued, ringing, in-progress, completed.

string

Filter by call type. Accepted values: inbound, outbound, web.

Request

curl -X GET "https://api.verbeo.ai/calls" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.verbeo.ai/calls?limit=20&callType=outbound&status=completed" \
  -H "Authorization: Bearer YOUR_API_KEY"

const params = new URLSearchParams({
  limit: "20",
  callType: "outbound",
  status: "completed",
});
const response = await fetch(
  `https://api.verbeo.ai/calls?${params}`,
  {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
    },
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.verbeo.ai/calls",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={
        "limit": 20,
        "callType": "outbound",
        "status": "completed",
    },
)
data = response.json()

Response

A successful request returns 200 OK with a calls array and pagination metadata.

object[]

required

Array of call objects.

Show call object properties

string

required

Verbeo UUID for this call.

string

required

Provider call identifier. For calls placed over a LiveKit SIP number this is the call’s room name (e.g. outbound-1a2b3c4d).

string

required

Direction and channel: "inbound", "outbound", or "web".

string

required

The originating phone number in E.164 format.

string

required

The destination phone number in E.164 format.

string

required

Current or final call status: queued, ringing, in-progress, or completed.

number

Call duration in seconds. Present after the call ends.

string

Reason the call ended: user_hangup, agent_hangup, completed, timeout, or error.

string

ISO 8601 timestamp of when the call was answered.

string

ISO 8601 timestamp of when the call ended.

string

required

ISO 8601 timestamp of when the call record was created.

string

required

UUID of the agent that handled the call.

string

UUID of the workspace phone number used for the call.

string

AI-generated summary of the call. Available after post-call analysis completes.

object

Structured fields extracted by post-call analysis, keyed by the field names you configured on the agent.

object

required

Pagination metadata.

Show pagination properties

number

required

The limit value used for this response.

number

required

The offset value used for this response.

boolean

required

true when there are additional records beyond this page.

Example response

{
  "calls": [
    {
      "id": "772g0622-g41d-63f6-c938-668877662222",
      "call_sid": "outbound-1a2b3c4d",
      "call_type": "outbound",
      "from_number": "+1987654321",
      "to_number": "+1234567890",
      "status": "completed",
      "duration": 245,
      "disconnection_reason": "agent_hangup",
      "started_at": "2024-01-15T10:30:00Z",
      "ended_at": "2024-01-15T10:34:05Z",
      "created_at": "2024-01-15T10:29:55Z",
      "agent_id": "550e8400-e29b-41d4-a716-446655440000",
      "phone_number_id": "661f9511-f30c-52e5-b827-557766551111",
      "summary": "Customer called about order status. Issue was resolved — order ships tomorrow.",
      "analysis_data": {
        "issue_resolved": true,
        "follow_up_required": false
      }
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Pagination example

To fetch all completed outbound calls in pages of 50:

# Page 1
curl "https://api.verbeo.ai/calls?limit=50&offset=0&callType=outbound&status=completed" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Page 2
curl "https://api.verbeo.ai/calls?limit=50&offset=50&callType=outbound&status=completed" \
  -H "Authorization: Bearer YOUR_API_KEY"

Continue incrementing offset by limit until pagination.hasMore is false.

Error responses

Status	Description
`401`	Invalid or missing API key
`500`	Internal server error

Overview

Assistants

Tools

Phone Numbers

Calls

Campaigns

Webhooks

GET /calls — List call history

Endpoint

Query parameters

Request

Response

Example response

Error responses

​Endpoint

​Query parameters

​Request

​Response

​Example response

​Pagination example

​Error responses

Endpoint

Query parameters

Request

Response

Example response

Pagination example

Error responses