> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cawme.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Buscar Chamada

> GET /v1/calls/:callId — Retorna o status e os detalhes de uma chamada

`GET /v1/calls/:callId`

Retorna o estado atual de uma chamada, incluindo seu status e timestamps.

## Requisição

### Cabeçalhos

| Cabeçalho       | Valor            |
| --------------- | ---------------- |
| `Authorization` | `Bearer <token>` |

### Parâmetros de caminho

| Parâmetro | Tipo     | Descrição                            |
| --------- | -------- | ------------------------------------ |
| `callId`  | `string` | O ID da chamada (ex.: `call_xyz789`) |

## Resposta `200`

| Campo          | Tipo             | Descrição                                                       |
| -------------- | ---------------- | --------------------------------------------------------------- |
| `id`           | `string`         | ID único da chamada                                             |
| `instance_id`  | `string`         | Instância que realizou a chamada                                |
| `type`         | `string`         | `FIXED_TTS`, `FIXED_AUDIO`, `DYNAMIC_STREAM` ou `DYNAMIC_AGENT` |
| `status`       | `string`         | Status atual da chamada                                         |
| `target_phone` | `string`         | Número de destino                                               |
| `started_at`   | `string \| null` | Timestamp ISO 8601 de quando a chamada conectou                 |
| `ended_at`     | `string \| null` | Timestamp ISO 8601 de quando a chamada encerrou                 |
| `created_at`   | `string`         | Timestamp ISO 8601                                              |

### Status da chamada

| Status        | Descrição                             |
| ------------- | ------------------------------------- |
| `QUEUED`      | Chamada aguardando para ser realizada |
| `RINGING`     | Chamada discando para o destinatário  |
| `IN_PROGRESS` | Destinatário atendeu                  |
| `COMPLETED`   | Chamada encerrada com sucesso         |
| `FAILED`      | Chamada falhou ou foi encerrada       |

```json theme={null}
{
  "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ódigo | Descrição                                         |
| ------ | ------------------------------------------------- |
| `401`  | Token ausente ou inválido                         |
| `404`  | Chamada não encontrada ou não pertence ao usuário |

## Exemplo

```bash theme={null}
curl https://cawme.com/api/v1/calls/call_xyz789 \
  -H "Authorization: Bearer <token>"
```