GET /calls — Get call by ID

This endpoint returns the complete record for a specific call. In addition to the summary fields available in the List calls response, it includes the full conversation transcript, enhanced transcript, dynamic variables that were passed at call initiation, and metadata about the agent and phone number involved.

The transcript, analysis_data, and summary fields are populated after post-call analysis completes, usually within seconds of the call ending. If generating them fails, Verbeo keeps retrying for up to 3 hours, so they can take that long to appear. If you retrieve a call record immediately after it ends, these fields may be absent or empty.

Endpoint

GET https://api.verbeo.ai/calls?callId={callId}

Query parameters

string

required

Verbeo UUID of the call to retrieve.

Request

curl -X GET "https://api.verbeo.ai/calls?callId=772g0622-g41d-63f6-c938-668877662222" \
  -H "Authorization: Bearer YOUR_API_KEY"

const callId = "772g0622-g41d-63f6-c938-668877662222";
const response = await fetch(
  `https://api.verbeo.ai/calls?callId=${callId}`,
  {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
    },
  }
);
const call = await response.json();

import requests

call_id = "772g0622-g41d-63f6-c938-668877662222"
response = requests.get(
    f"https://api.verbeo.ai/calls?callId={call_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
call = response.json()

Response

A successful request returns 200 OK with the full call object.

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

Originating phone number in E.164 format.

string

required

Destination phone number in E.164 format.

string

required

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

number

Call duration in seconds.

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

Full conversation transcript as a plain-text string with speaker labels and timestamps.

string

Processed version of the transcript with additional formatting or corrections.

string

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

object

Structured data extracted from the call by post-call analysis. Keyed by the field names you configured on the agent.

object

The key-value pairs that were passed when the call was initiated via dynamic_variables (dynamicVariables in version 1).

object

Metadata about the agent that handled the call.

Show agents properties

string

Display name of the agent.

object

Metadata about the workspace phone number used for the call.

Show phone_numbers properties

string

The phone number in E.164 format.

string

The display name assigned to this number in the workspace.

Example response

{
  "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",
  "transcript": "Agent: Hello, how can I help you today?\nUser: I'd like to check on my order...",
  "enhanced_transcript": "...",
  "summary": "Customer called about order status. Issue was resolved — order ships tomorrow.",
  "analysis_data": {
    "issue_resolved": true,
    "follow_up_required": false
  },
  "dynamic_variables": {
    "customer_name": "John Doe",
    "order_id": "ORD-12345"
  },
  "agents": {
    "agent_name": "Customer Support Agent"
  },
  "phone_numbers": {
    "phone_number": "+1987654321",
    "friendly_name": "Main Support Line"
  }
}

Error responses

Status	Description
`401`	Invalid or missing API key
`404`	Call not found — verify the `callId` belongs to your workspace
`500`	Internal server error

Overview

Assistants

Tools

Phone Numbers

Calls

Campaigns

Webhooks

GET /calls — Get call by ID

Endpoint

Query parameters

Request

Response

Example response

Error responses

​Endpoint

​Query parameters

​Request

​Response

​Example response

​Error responses

Endpoint

Query parameters

Request

Response

Example response

Error responses