# List orders (/docs/api-reference/orders/get-all)

`GET /v1/orders`

Lists the partner's orders, newest first, with optional filters.

Returns `{ orders, pagination }`. Each summary has `id`, `referenceId`, `origin`,
`status`, `total`, the latest `payment` and `itemCount`; read one order for its items
and timeline.
            
Orders created through the API, the dashboard and the partner's sites are all listed; `channel`
(`api`, `dashboard` or `site`, the values of `origin.channel`) keeps one of them. With a
site credential, only the orders of that site are listed. `orderStatuses` takes the
values of `status` and matches the status the order reads now. Filters combine with AND;
repeated `productTypes` or `orderStatuses` values combine with OR. A `productTypes` filter
selects orders containing at least one item of that type and still returns the whole order. Filters apply
before counting and paging, so send the same filters on every page.
            
Use flat `page` (default 1) and `limit` (default 10, 1 to 100) query parameters.
`cursor`, `skip`, `offset`, nested paging keys and repeated paging parameters return
`400` with code `10001` (`INVALID_REQUEST`).

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `page` | query | no | `integer` | One-based page number. Default 1. |
| `limit` | query | no | `integer` | Page size, 1 to 100. Default 10. |
| `startDate` | query | no | `string` | Only orders created at or after this time (UTC). ISO 8601 date-time. A value with Z or an offset is converted to UTC; a value without a zone is read as UTC, and a date alone means 00:00 UTC on that day. |
| `endDate` | query | no | `string` | Only orders created at or before this time (UTC). ISO 8601 date-time. A value with Z or an offset is converted to UTC; a value without a zone is read as UTC, and a date alone means 00:00 UTC on that day. |
| `minAmount` | query | no | `number` | Only orders whose `total.amount`, in the order's currency, is at least this value. |
| `maxAmount` | query | no | `number` | Only orders whose `total.amount`, in the order's currency, is at most this value. |
| `search` | query | no | `string` | An order id returns that order only; any other text matches part of the email or full name of the user who placed the order. |
| `referenceId` | query | no | `string` | Only the order with exactly this `referenceId`. |
| `channel` | query | no | `string` | Only orders created through this channel, the same values as `origin.channel`: `api`, `dashboard` or `site`. |
| `productTypes` | query | no | `string[]` | Only orders containing at least one item of one of these product types. Repeat the parameter for several types, for example `productTypes=esim&productTypes=giftCard`. |
| `orderStatuses` | query | no | `string[]` | Only orders currently in one of these statuses, the same values as `status`. Repeat the parameter for several statuses. |

## Responses

### 200

OK

- `text/plain`: `OrderList`
- `application/json`: `OrderList`
- `text/json`: `OrderList`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 401

Unauthorized

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

### 500

Internal Server Error

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.