# List orders (/api-reference/orders/v1-order-get)

Returns the account's orders with their status, product, postage, and delivery progress. Supports the id, status, paid, product, postage, and showRecipients filters, plus pageNumber/pageSize pagination.

## `GET /v1/order`

### Parameters

- `id` (query) — Filter orders by a list of order IDs separated by comma.
- `status` (query) — Filter orders by status (e.g., 'Draft', 'Mailed').
- `paid` (query) — Tri-state filter on payment state: omit the parameter to return orders regardless of payment state, true for paid orders only, false for unpaid orders only. Any other value is rejected with a 400.
- `product` (query) — Filter orders by product type.
- `postage` (query) — Filter orders by postage type.
- `showRecipients` (query) — Filter whether to return recipient information.
- `pageNumber` (query) — Used for pagination, the page number. Defaults to 0.
- `pageSize` (query) — Used for pagination, the number of records to retrieve. Defaults to 100.

### Responses

- `200` — Successful operation
- `400` — Something went wrong
- `401` — Authorization key not valid
- `403` — Your subscription tier does not include API access. No response body is returned — do not attempt to parse one.
- `500` — Internal Server Error