# List vouchers

**GET /vouchers**

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 voucher reference or delivery address
- **sort** (string)
  Sort vouchers by one or more fields. Use '-' prefix for descending order.
  Available fields: created_at, updated_at, order_date (sorts by order's created_at)
  Default: -updated_at
- **filter[store.id][]** (array[string(uuid)])
  Filter by store UUIDs. Can specify multiple store IDs for OR logic.
- **filter[packaging_option.id][]** (array[string(uuid)])
  Filter by packaging option UUIDs
- **filter[delivery_method.id][]** (array[string(uuid)])
  Filter by delivery method UUIDs
- **filter[shippable.type][]** (array[string])
  Filter by shipping type
- **filter[shippable.status][]** (array[string])
  Filter by shipping status
- **filter[tags][]** (object)
  Filter by custom tags


## Responses
### 200
List of vouchers 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)