# Filter invoices by several statuses

The `status` filter on `GET /v1/invoices` accepts a comma-separated list, so one request covers several statuses.

Aug 3, 2026 · Improved

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=DRAFT` behaves exactly as before, so existing integrations need no update.
- `ACTIVE` and `EXPIRED` still 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/invoices` — List invoices, optionally filtered by one or more statuses

## Where to go next

- [List invoices](/invoices/listInvoices)

---

Full OpenAPI spec: https://docs.beel.es/api/openapi