Comment parcourir les longues listes de factures et de devis ?

Par curseur : GET /v1/invoices et GET /v1/quotes rendent next_cursor tant qu'il reste des éléments ; repassez-le tel quel en paramètre cursor. limit fixe la taille de page, de 1 à 200 (50 par défaut). Les plus récents viennent d'abord.

1. Premier appel : GET /v1/invoices?limit=100.
2. Si la réponse porte next_cursor, rappelez avec GET /v1/invoices?limit=100&cursor=<next_cursor>.
3. Arrêtez quand next_cursor est absent.

Pour les factures, from et to (dates AAAA-MM-JJ, incluses) bornent la date du document, et status filtre par statut (plusieurs, séparés par des virgules). Le filtre s'applique côté serveur, sur toute la liste.

Un limit hors de 1 à 200 rend 400 : « Le paramètre « limit » doit être un entier compris entre 1 et 200. »

Pourquoi un curseur et non des numéros de page

Un décalage par page duplique ou saute des lignes dès qu'une facture est créée pendant le parcours. Le curseur reprend exactement où la page précédente s'est arrêtée.

Mis à jour le 30 septembre 2026.