Filter invoices by several statuses
The status filter on GET /v1/invoices accepts a comma-separated list, so one request covers several statuses.
ChangelogImproved
The status filter on GET /v1/invoices now accepts a comma-separated list, so a single paginated request can return invoices in any of several statuses.
What else changed
GET /v1/invoices?status=DRAFT,ISSUED,PAID— matches invoices in any of the listed statuses (OR). Previously this needed one request per status, which broke pagination on the merged result.- Nothing changes for a single value.
?status=DRAFTbehaves exactly as before, so existing integrations need no update. ACTIVEandEXPIREDstill resolve to the same stored status, so listing both is equivalent to listing either one.- Excluding a status is not supported: list the ones you do want instead.
Endpoints
- GET/v1/invoicesList invoices, optionally filtered by one or more statuses
Where to go next
Webhook subscriptions report their health, and pause when the endpoint is dead
A subscription now says how its endpoint is doing, emails you when it keeps failing, and is paused after 25 failed deliveries over more than 48 hours.
external_reference on invoices
Invoices accept an `external_reference` — your own order id — that you can filter by and that is enforced as unique.