Skip to main content
GET
/
v1
/
calls
List calls
curl --request GET \
  --url https://api.vatel.ai/v1/calls \
  --header 'Authorization: Bearer <token>'
{
  "calls": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "graph_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "party_number": "<string>",
      "status": "connected",
      "source": "twilio",
      "termination_reason": "<string>",
      "extracted_variables": [
        {
          "name": "<string>",
          "type": "system",
          "description": "<string>",
          "value": "<unknown>",
          "dataType": "string",
          "rationale": "<string>"
        }
      ],
      "outbound": true,
      "outbound_contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "outbound_list_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "<string>",
      "connected_at": "<string>",
      "started_at": "<string>",
      "ended_at": "<string>",
      "summary": "<string>",
      "transcript": {
        "entries": [
          {
            "index": 123,
            "role": "<string>",
            "message": "<string>",
            "type": "message",
            "toolCall": {
              "itemId": "<string>",
              "callId": "<string>",
              "toolName": "<string>",
              "arguments": "<string>",
              "output": "<string>",
              "startedAt": "2023-11-07T05:31:56Z",
              "endedAt": "2023-11-07T05:31:56Z"
            },
            "toolCallOutput": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "durationMs": 123,
            "turnId": "<string>"
          }
        ]
      },
      "cost": 123,
      "tags": [
        "<string>"
      ],
      "duration_seconds": 123
    }
  ],
  "pagination": {
    "page": 123,
    "page_size": 123,
    "total": 123,
    "total_pages": 123,
    "has_next": true,
    "has_prev": true
  }
}

Authorizations

Authorization
string
header
required

Send your organization API key as Authorization: Bearer <key>.

Query Parameters

organization_id
string<uuid>

Organization UUID. Required when the request is authenticated with the internal server API key; ignored for organization API keys.

page
integer
default:1

Page number (1-based). Default 1.

Required range: x >= 1
page_size
integer
default:20

Page size. Default 20, maximum 100.

Required range: 1 <= x <= 100
agent_ids
string

Comma-separated agent UUIDs to restrict results.

status
enum<string>

Call lifecycle status.

Available options:
connected,
started,
in_progress,
auth_failed,
ended
source
enum<string>

How the call entered the platform.

Available options:
twilio,
sip,
simulation,
api
date_from
string

Filter calls with created_at on or after this instant (RFC3339 or ISO8601 string accepted by the backend).

date_to
string

Filter calls with created_at on or before this instant.

outbound
enum<string>
Available options:
true,
false

Substring match on party number (max 256 characters).

tag
string

Filter by tag (max 128 characters).

outcome
enum<string>

Filter by termination outcome / reason bucket.

Available options:
transferred,
ended_by_agent,
ended_by_user

Response

Paginated calls

calls
object[]
required
pagination
object
required