Sign in
calls

Get a call

Poll a single call. Returns the full detail fields (including transcript_full) that the list endpoint omits.

get/calls/{call_id}

Path parameters

call_idstring required

Headers

X-API-Keystring nullable

Response

Successful Response

call_idstring required
customer_idstring required
task_idstring required
target_phonestring required
language'en' | 'es' | 'fr' | 'de' | 'hi' | 'ru' | 'pt' | 'ja' | 'it' | 'nl' | 'sr' | 'tr' | 'pl' | 'auto' required
status'queued' | 'dialing' | 'in_progress' | 'completed' | 'failed' | 'cancelled' required
call_sidstring nullable

The Twilio Call SID. null until dialing starts.

started_atstring date-time nullable
ended_atstring date-time nullable
duration_secinteger nullable
outcome_type'success_booked' | 'success_refused' | 'success_no_booking' | 'failed_no_answer' | 'failed_voicemail' | 'failed_busy' | 'failed_short_hangup' | 'failed_technical' | 'failed_no_agent_available' nullable

Set once the call is terminal. success_* outcomes are billed 10 credits; failed_* are billed 0. failed_no_agent_available = the venue kept the agent in a hold queue past the hold budget and no human ever picked up.

outcome_summarystring nullable
outcome_charge_centsinteger

Despite the name, this is in the same credit unit as credits_reserved. A successful call settles at 10 (the charge), unsuccessful at 0 - not the 30 held.

created_atstring date-time required
has_recordingboolean
recording_urlstring nullable

A RELATIVE path to this service's recording proxy endpoint (/calls/{call_id}/recording) when a recording exists - never the raw Twilio mp3 URL. null when has_recording is false. Retrieval isn't documented here.

reservation_signalsstring[] nullable

Short free-text signals (<10 short strings) about the reservation outcome. Always included (not detail-gated like transcript_full).

supervisor_decisionsobject[] nullable

Only populated on GET /calls/{call_id}, not on the GET /calls list (same heavy-field gating as transcript_full).

Example response

{
  "call_id": "c_abc123",
  "customer_id": "cus_xyz",
  "task_id": "t_abc123",
  "target_phone": "+15551234567",
  "call_sid": "CAxxxxxxxx"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.