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

# Pagination

> Pagination par page avec totaux sur tous les endpoints de liste

Tous les endpoints de liste et de recherche retournent des resultats pagines.

## Parametres

| Parametre | Type    | Defaut | Max | Description                           |
| --------- | ------- | ------ | --- | ------------------------------------- |
| `page`    | integer | 1      | —   | Numero de page (indexe a partir de 1) |
| `size`    | integer | 20     | 100 | Resultats par page                    |

Pour les endpoints GET, passez-les en parametres de requete. Pour les endpoints de recherche POST, incluez-les dans le corps de la requete.

## Format de reponse

Chaque reponse paginee inclut un objet `pagination` :

```json theme={null}
{
  "data": [
    { "id": "cll_abc123", "type": "call", "..." : "..." },
    { "id": "msg_def456", "type": "sms", "..." : "..." }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "total_count": 156,
    "total_pages": 8,
    "has_more": true
  }
}
```

| Champ         | Description                                             |
| ------------- | ------------------------------------------------------- |
| `page`        | Numero de la page actuelle                              |
| `size`        | Resultats par page                                      |
| `total_count` | Total des resultats correspondants sur toutes les pages |
| `total_pages` | Nombre total de pages                                   |
| `has_more`    | `true` s'il y a d'autres pages apres celle-ci           |

## Parcourir les pages

```javascript theme={null}
let page = 1;
let hasMore = true;

while (hasMore) {
  const response = await fetch(
    `https://api.withallo.com/v2/api/conversations?page=${page}&size=100`,
    { headers: { "Authorization": "Api-Key ak_live_your_key" } }
  );

  const { data, pagination } = await response.json();
  // Traiter les donnees...

  hasMore = pagination.has_more;
  page++;
}
```