# Listar histórico de chamadas

`GET /call/history`

Pasta: **Chamadas**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Listar histórico de chamadas

Lista o histórico persistido de chamadas da instância (voz/vídeo via WebRTC ou SIP), com filtros opcionais e paginação.

## Endpoint

``` http
GET {{baseUrl}}/call/history
```

## Autenticação

``` http
token: {{token}}
```

## Query

| Parâmetro | Obrigatório | Descrição |
| --- | --- | --- |
| limit | Não | Quantidade máxima de itens |
| offset | Não | Deslocamento para paginação |
| direction | Não | `inbound` ou `outbound` |
| status | Não | `ringing`, `answered`, `missed`, `rejected`, `failed` |
| leg | Não | Perna do operador: `sip`, `webrtc` ou `none` |
| from | Não | Início do intervalo (RFC3339) |
| to | Não | Fim do intervalo (RFC3339) |

## Resposta

``` json
{
  "success": true,
  "total": 1,
  "items": [
    {
      "id": "...",
      "instance_id": "...",
      "call_id": "3EB0FAKECALL",
      "direction": "inbound",
      "peer_jid": "5511888888888@s.whatsapp.net",
      "peer_phone": "5511888888888",
      "operator_leg": "sip",
      "media_type": "audio",
      "status": "answered",
      "ringing_at": "2026-07-29T15:00:00Z",
      "answered_at": "2026-07-29T15:00:05Z",
      "ended_at": "2026-07-29T15:03:20Z",
      "duration_ms": 195000,
      "ring_ms": 5000
    }
  ]
}
```

## Observações

Histórico é gravado pelo runtime de calls do pod. Use `GET /call/history/{call_id}` para um item específico.

## Query

- `limit` = `50`
- `offset` = `0`

## cURL

```bash
curl -X GET "{{baseUrl}}/call/history" \
  -H "token: {{token}}"
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=chamadas/listar-historico-de-chamadas)