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

# Pagination et filtres

> Comment les endpoints de liste reçoivent les filtres et renvoient les résultats page par page.

Les endpoints de liste utilisent la méthode `POST`, avec les filtres dans le corps JSON.

<Note>
  Les listes ne contiennent que les éléments auxquels l'utilisateur de l'ID token a accès : en général, tous les clients de la fiduciaire, ou seulement certains d'entre eux si la fiduciaire a restreint l'utilisateur.

  **Voir aussi :** [Accès aux données](/fr/api/data-access)
</Note>

## Listes paginées

Les endpoints suivants sont paginés :

* [`POST /customers`](/fr/api/endpoints/search-customers)
* [`POST /mandates`](/fr/api/endpoints/search-mandates)
* [`POST /banks`](/fr/api/endpoints/list-banks)
* [`POST /payroll-providers`](/fr/api/endpoints/list-payroll-providers)

Ils acceptent deux champs dans le corps de la requête :

| Champ    | Par défaut | Description                                                                               |
| -------- | ---------- | ----------------------------------------------------------------------------------------- |
| `limit`  | `50`       | Nombre d'enregistrements à renvoyer. Toute valeur supérieure à `200` est ramenée à `200`. |
| `offset` | `0`        | Nombre d'enregistrements à ignorer.                                                       |

Ils renvoient :

| Champ             | Description                                                                         |
| ----------------- | ----------------------------------------------------------------------------------- |
| `records`         | La page courante.                                                                   |
| `recordsTotal`    | Nombre d'enregistrements visibles par l'utilisateur, avant application des filtres. |
| `recordsFiltered` | Nombre d'enregistrements qui correspondent aux filtres.                             |

Pour parcourir tous les résultats, augmentez `offset` de la valeur de `limit` jusqu'à ce que `offset` atteigne `recordsFiltered`.

## Champs inconnus

`POST /customers`, `POST /mandates` et `POST /payroll-providers` rejettent tout champ inconnu dans le corps de la requête. Ils renvoient alors `400 unknownField`, avec la liste des champs en cause dans `fields`.

Si vous recevez cette erreur, vérifiez l'orthographe de vos filtres.

## Listes non paginées

Les endpoints suivants renvoient en une seule fois tous les éléments correspondants, sous forme de tableau simple :

* [`GET /customers`](/fr/api/endpoints/list-all-customers)
* [`POST /coda-files`](/fr/api/endpoints/list-coda-files)
* [`POST /codb-files`](/fr/api/endpoints/list-codb-files)

Pour les fichiers, confirmez chaque fichier une fois téléchargé afin de garder des réponses légères : les fichiers confirmés ne sont plus listés.