Skip to main content
GET
Get a call

Authorizations

Authorization
string
header
required

Your organization's API key (sk_cont_...), sent as Authorization: Bearer sk_cont_.... Keep it server-side.

Path Parameters

call_id
string
required

Response

Successful Response

The call object in every event and in GET /v1/calls/{id}.

call_id
string
required

Stable id for the life of the call.

direction
string
required

outbound or inbound.

status
string
required

queuedin_progressended, or failed if the call never went out.

agent_id
string | null

The agent that handled the call.

analysis
Analysis · object | null

Null until call.analyzed. Then summary (text) and extracted_data (the fields configured on your agent).

disconnection_reason
string | null

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

disposition
string | null

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

duration_ms
integer | null

Call length in milliseconds.

ended_at
string | null

ISO 8601 timestamp. Null until the call ends.

from_number
string | null

The caller ID.

metadata
Metadata · object

Your metadata, echoed back untouched.

recording_url
string | null

Presigned link to the recording. Expires after about an hour; null until the recording is available. Use GET /v1/calls/{call_id}/recording for a fresh one.

source
string | null

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

started_at
string | null

ISO 8601 timestamp.

to_number
string | null

The number dialed.

variables
Variables · object

The variables the call was created with.