The call object

{
  "call_id": "9d2f7a3c-...",
  "agent_id": "3f1c1b2e-...",
  "status": "ended",
  "disposition": "answered",
  "direction": "outbound",
  "source": "api",
  "to_number": "+15555550100",
  "from_number": "+15555550199",
  "started_at": "2026-09-10T14:03:11+00:00",
  "ended_at": "2026-09-10T14:04:35+00:00",
  "duration_ms": 84000,
  "disconnection_reason": "agent_hangup",
  "recording_url": "https://...",
  "variables": { "patient_name": "Jane Doe" },
  "metadata": { "your_order_id": "ORD-8812" },
  "analysis": {
    "summary": "Jane confirmed her appointment for the 15th ...",
    "extracted_data": { "appointment_confirmed": true }
  }
}

string

queued → in_progress → ended, or failed if the call never went out.

string | null

What happened on the wire: answered, answering_machine, no_answer, busy, rejected, unreachable, invalid_number, carrier_failure. null until the call ends.

string | null

api for calls you created. Other values mean the call was started from the Contour dashboard or another channel.

string | null

Why the call ended, for example agent_hangup, user_hangup, voicemail, no_answer, max_duration.

string | null

A presigned link that expires after about an hour. null until the recording is available. Use GET /v1/calls/{call_id}/recording for a fresh link at any time.

object

The variables the call was created with.

object

Your metadata, echoed back untouched.

object | null

null until call.analyzed. Then summary (text) and extracted_data, whose keys are the fields configured on your agent.

The transcript is never included. Full field list: Get a call.

Get started

Calls

Webhooks

The call object