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

# Listar Contatos

> Retorna a lista de contatos sincronizados com paginação

## Descrição

Retorna a lista de contatos sincronizados com a instância, com suporte a paginação.

## Request

### Headers

```
Client-Token: SEU_CLIENT_TOKEN
```

### Query Parameters

| Campo      | Tipo   | Obrigatório | Descrição                           |
| ---------- | ------ | ----------- | ----------------------------------- |
| `page`     | number | Não         | Página atual (default: 1)           |
| `pageSize` | number | Não         | Quantidade por página (default: 20) |

## Response

### Sucesso (200)

```json theme={null}
{
  "contacts": [
    {
      "phone": "5511999999999",
      "name": "João Silva",
      "pushName": "João"
    }
  ],
  "total": 500,
  "page": 1
}
```

## Exemplo cURL

```bash theme={null}
curl -X GET 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/contacts?page=1&pageSize=20' \
  -H 'Client-Token: SEU_CLIENT_TOKEN'
```