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.
Request
- Base URLhttps://devs.adaptyvbio.com
- URLhttps://devs.adaptyvbio.com/api/v1/invoices
- AuthHTTP bearer
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 and at(...) JSONB path access. Example: asc(date(at(metadata,start_date))).
- Prefix short form — -field (descending), +field or bare field (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
Example response
{
"items": [
{
"hosted_invoice_url": "https://invoice.stripe.com/i/acct_1234/test_5678"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.