Skip to main content
GET /v1/calls/:callId Retorna o estado atual de uma chamada, incluindo seu status e timestamps.

​
Requisição

​
Cabeçalhos

CabeçalhoValor
AuthorizationBearer <token>

​
Parâmetros de caminho

ParâmetroTipoDescrição
callIdstringO ID da chamada (ex.: call_xyz789)

​
Resposta 200

CampoTipoDescrição
idstringID único da chamada
instance_idstringInstância que realizou a chamada
typestringFIXED_TTS, FIXED_AUDIO, DYNAMIC_STREAM ou DYNAMIC_AGENT
statusstringStatus atual da chamada
target_phonestringNúmero de destino
started_atstring | nullTimestamp ISO 8601 de quando a chamada conectou
ended_atstring | nullTimestamp ISO 8601 de quando a chamada encerrou
created_atstringTimestamp ISO 8601

​
Status da chamada

StatusDescrição
QUEUEDChamada aguardando para ser realizada
RINGINGChamada discando para o destinatário
IN_PROGRESSDestinatário atendeu
COMPLETEDChamada encerrada com sucesso
FAILEDChamada falhou ou foi encerrada
{
  "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"
}

​
Erros

CódigoDescrição
401Token ausente ou inválido
404Chamada não encontrada ou não pertence ao usuário

​
Exemplo

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