List invoices
Lists every invoice generated for the caller’s organization so clients can display billing history, monitor outstanding balances, and reconcile payments. Results are sorted by creation date by default and include due dates, currency, and current status for each invoice.
Authorizations
Biscuit-based bearer token. Obtain tokens from the Adaptyv Portal or via the /tokens endpoint. Tokens encode organization membership and role-based capabilities; the API verifies the token's cryptographic signature and authorization claims before processing requests. Use /tokens/attenuate to create restricted tokens for delegation.
Query Parameters
Maximum number of items to return (1-100, default 50).
Number of items to skip (default 0).
Filter expression in s-expression syntax.
Comparison: eq(field,value), neq(field,value), gt(field,value),
lt(field,value), gte(field,value), lte(field,value),
contains(field,substring)
Range/set: between(field,lo,hi), in(field,v1,v2,...)
Logical: and(expr1,expr2,...), or(expr1,expr2,...), not(expr)
Null checks: is_null(field), is_not_null(field)
JSONB access: at(field,key) — e.g. eq(at(metadata,score),42)
Cast functions: float(expr), int(expr), text(expr),
timestamp(expr), date(expr)
Example: and(gte(created_at,2026-01-01),eq(status,draft))
Sort expression. Supports multi-column sort (comma-separated, up to 8), JSONB path access, and type casts.
Three accepted surface forms produce the same ordering:
- Canonical —
desc(field)/asc(field); also wraps casts andat(...)JSONB path access. Example:asc(date(at(metadata,start_date))). - Prefix short form —
-field(descending),+fieldor barefield(ascending). GitHub / Stripe / Jira convention. Bare field only; no casts. - Suffix short form —
field:asc/field:desc. Also bare field.
Examples: -created_at, -created_at,+name, created_at:desc,
desc(created_at),asc(name), asc(at(metadata,score)).
Response
Invoice list
Paginated list response with offset-based navigation metadata.
All list endpoints return this shape. Use offset and limit query
parameters to page through results; total reports how many items
match the query across all pages.