> ## Documentation Index
> Fetch the complete documentation index at: https://api-doc.fidly.be/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination et filtres

> Le comportement des listes et des filtres dans toute l'API.

## Pagination

Chaque endpoint de liste est paginé avec les deux mêmes paramètres de query :

| Paramètre | Bornes  | Défaut |
| --------- | ------- | ------ |
| `limit`   | 1–100   | 50     |
| `offset`  | 0–10000 | 0      |

La réponse enveloppe la page :

```json theme={null}
{ "items": [ ... ], "total": 123, "limit": 50, "offset": 0 }
```

Les documents sont triés du plus récent au plus ancien.

## Filtres

* Les filtres sont des paramètres de query (`?origin=peppol`, `?type=company`...).
  Chaque endpoint de liste documente les siens dans la référence API.
* Les filtres d'énumération acceptent une **liste séparée par des virgules**,
  interprétée comme un OU logique : `?origin=manual,peppol,mail`.
* Une valeur de filtre inconnue renvoie `400 invalid_filter` avec les valeurs
  admises dans le message.

## Récupérer toutes vos données

`offset` est plafonné à 10000 — une protection du service : paginer très profond
par offset est coûteux. Ce plafond n'empêche pas une récupération complète :

* **Documents** — la seule ressource volumineuse : découpez par fenêtres de dates
  avec `issue_date_from` / `issue_date_to` (une année à la fois, par exemple) et
  paginez à l'intérieur de chaque fenêtre. `total` vous dit quand une fenêtre doit
  être resserrée.
* **Les autres ressources** restent très en dessous du plafond (quelques comptes
  bancaires, journaux ou adresses de livraison par entreprise).