# List orders

**GET /orders**

Requires `view_orders` permission


## Servers
- GB server: https://api.gb.enjovia.app (GB server)
- EU server: https://api.eu.enjovia.app (EU server)
- US server: https://api.us.enjovia.app (US server)
- AU server: https://api.au.enjovia.app (AU server)


## Authentication methods
- Bearer auth


## Parameters
### Headers
- **Account-ID** (string(uuid))
  Account ID - Can be found on the Dashboard under Settings → API Tokens


### Query parameters
- **page** (integer)

- **per_page** (integer)

- **search** (string | null)
  Search by order reference, voucher reference, or buyer name
- **sort** (string)
  Sort orders by one or more fields. Use '-' prefix for descending order.
  Available fields: created_at, updated_at
  Default: -updated_at
- **filter[is_live][]** (array[string])
  Filter by live/test status. Can specify multiple values for OR logic.
- **filter[is_imported][]** (array[string])
  Filter by import status. Can specify multiple values for OR logic.
- **filter[store.id][]** (array[string(uuid)])
  Filter by store UUIDs. Can specify multiple store IDs for OR logic.
- **filter[transaction.currency_code][]** (array[string])
  Filter by transaction currency codes. Can specify multiple currencies.
- **filter[type][]** (array[string])
  Filter by order type (online/offline). Can specify multiple types.
- **filter[payment_gateway][]** (array[string])
  Filter by payment gateway. Can specify multiple gateways.
- **filter[tags][]** (object)
  Filter by custom tags (key-value pairs)


## Responses
### 200
List of orders with pagination

#### Body: application/json (object)
- **data** (array[object])

- **links** (object)

- **meta** (object)


### 401
Unauthorized

### 403
Forbidden - Requires view_orders permission


[Powered by Bump.sh](https://bump.sh)