Skip to main content
GET /v1/calls/:callId Returns the current state of a call, including its status and timestamps.

​
Request

​
Headers

HeaderValue
AuthorizationBearer <token>

​
Path parameters

ParameterTypeDescription
callIdstringThe call ID (e.g., call_xyz789)

​
Response 200

FieldTypeDescription
idstringUnique call ID
instance_idstringInstance that placed the call
typestringFIXED_TTS, FIXED_AUDIO, DYNAMIC_STREAM, or DYNAMIC_AGENT
statusstringCurrent call status
target_phonestringDestination phone number
started_atstring | nullISO 8601 timestamp when the call connected
ended_atstring | nullISO 8601 timestamp when the call ended
created_atstringISO 8601 timestamp

​
Call statuses

StatusDescription
QUEUEDCall is waiting to be placed
RINGINGCall is dialling the recipient
IN_PROGRESSRecipient has answered
COMPLETEDCall ended successfully
FAILEDCall failed or was terminated
{
  "id": "call_xyz789",
  "instance_id": "inst_abc123",
  "type": "FIXED_TTS",
  "status": "IN_PROGRESS",
  "target_phone": "+14155550123",
  "started_at": "2026-03-01T10:01:15Z",
  "ended_at": null,
  "created_at": "2026-03-01T10:01:00Z"
}

​
Errors

CodeDescription
401Missing or invalid token
404Call not found or does not belong to the user

​
Example

curl https://cawme.com/api/v1/calls/call_xyz789 \
  -H "Authorization: Bearer <token>"