Documentación · Conceptos · API v1 · versión 2026-10-22
Paginación
Las listas de la API de Trevol usan cursores (starting_after); los SDK ofrecen iteradores que recorren todas las páginas.
Las listas devuelven un sobre {object: "list", data, has_more, next_cursor}. Pide la página siguiente con starting_after=<next_cursor>; limit cambia el tamaño de la página.
GET /v1/invoices
curl "https://api.trevol.si/v1/invoices?limit=100" \
-H "Authorization: Bearer $TREVOL_API_KEY"- Los listados de documentos filtran por
status,external_id,created_fromycreated_to; los de nómina, poremployee_codeyperiod_end_from/period_end_to(nunca por la cédula). - Si una página con
has_moreverdadero no traenext_cursor, usa eliddel último elemento. GET /v1/eventsguarda los eventos 30 días yGET /v1/requests, el registro de peticiones, otros 30.
Iteradores en los SDK
Cada SDK trae un iterador perezoso con su idioma: paginate devuelve un AsyncIterable en Node, un generador en Python y PHP, un Iterable en Java, un IAsyncEnumerable en C#, un iter.Seq2 en Go y un Enumerator::Lazy en Ruby. Pides la primera página, y el iterador sigue solo con next_cursor mientras has_more. En el README de cada SDK hay un ejemplo completo.