Call

The full Call object contains all information about a voice call, including status, transcript, recording, and variables. Returned by Get Call.

List Calls returns a lightweight version of this object that omits transcript, summary, recording_url, detected_gender, vars_provided, vars_extracted, and vars_collected for performance. Use Get Call to retrieve the full object.

Properties

string

required

Unique identifier for the call (UUID).

string

required

Type of call: phone_call or web_call.

string

required

Current status of the call.In Progress:

Status	Description
`initiated`	Call placed, waiting for recipient
`ringing`	Recipient’s phone is ringing
`ongoing`	Call connected and active

Completed:

Status	Description
`user_hangup`	Caller hung up
`agent_hangup`	Agent ended the call
`inactivity`	Timeout due to inactivity
`max_duration`	Ended by the server at the maximum call-length limit
`error_inactivity`	Error during inactivity handling

Failed:

Status	Description
`busy`	Line was busy
`no_answer`	No answer after timeout
`error`	Technical failure
`canceled`	Call canceled before connecting

string

Why the call never connected, in actionable terms. null once the call connected, and while it is still in flight.

Category	Meaning	What to do
`no_answer`	Rang out, or no final response before our dial timeout	Retry later
`busy`	The line was engaged	Retry later
`declined`	The recipient actively refused (e.g. Do Not Disturb)	Retry rarely
`not_in_service`	No such subscriber — the number is dead	Stop dialling it
`carrier_rejected`	The carrier would not place the call; the number may be fine	Usually trunk configuration or carrier congestion
`failed`	Any other failure	—

Finer-grained than call_status, which cannot separate a dead number from a misconfigured trunk. For calls placed before 2026-08-18 the two can disagree: call_status was recorded before the outcome was classified, while this is derived from the recorded failure — in which case this field is the accurate one.

object

Agent that handled the call. null if no agent assigned.

Show Agent properties

string

Agent name

integer

Agent version used for this call

string

The caller’s phone number in E.164 format.

string

The called phone number in E.164 format.

string

required

Call direction relative to the agent:

incoming - Call initiated TO the agent (inbound calls, web calls)
outgoing - Call initiated BY the agent (outbound calls via API)

integer

Unix timestamp (milliseconds) when the call started.

integer

Call duration in milliseconds. null if call hasn’t ended.

array

Structured transcript with speaker roles and timestamps. null if no transcript.

Show Transcript entry properties

string

agent, caller, or system (flow-agent automation events)

string

What was said

integer

Milliseconds from call start

string

Detected gender of the caller: male or female. null if not detected.

string

Signed URL to the call recording. Expires in 1 hour. null if no recording.

string

AI-generated summary of the call. null if not yet generated.

object

Variables provided when the call was created. Keys are variable names, values are strings.

object

Variables extracted after the call by AI processing. Keys are variable names, values are strings.

object

Variables collected during the call in real-time by the agent (e.g., via Collection nodes). Keys are variable names, values are strings.Variable names beginning with _ (e.g. _temp) are call-local: they are usable during the call but stripped before persistence and never returned in this field.

Example

{
  "call_id": "550e8400-e29b-41d4-a716-446655440000",
  "call_type": "phone_call",
  "call_status": "user_hangup",
  "failure_category": null,
  "agent": {
    "name": "Customer Support Agent",
    "version": 2
  },
  "from_number": "+15551234567",
  "to_number": "+15559876543",
  "direction": "outgoing",
  "start_timestamp": 1704067200000,
  "duration_ms": 120000,
  "transcript": [
    {
      "role": "agent",
      "content": "Hello, how can I help you?",
      "timestamp_ms": 0
    },
    {
      "role": "caller",
      "content": "I need help with my order",
      "timestamp_ms": 2500
    }
  ],
  "detected_gender": "male",
  "recording_url": "https://storage.voicy.co/recordings/...",
  "summary": "Customer inquiry about order status.",
  "vars_provided": {
    "customer_name": "John"
  },
  "vars_extracted": {
    "appointment_date": "2026-01-15"
  },
  "vars_collected": {
    "preferred_time": "morning"
  }
}

Overview

Models

Calls

Agents

Properties

Example

​Properties

​Example

Properties

Example