# List promotions

**GET /promotions**

Get a list of active promotions with their codes for the current account


## 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


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

- **page** (integer)

- **filter[is_active]** (boolean)
  Filter by active status
- **filter[currency_code]** (string)
  Filter promotions by currency code
- **filter[has_codes]** (boolean)
  Filter promotions that have codes
- **filter[stores.id][]** (array[string(uuid)])
  Filter by store UUIDs
- **filter[tags][]** (object)
  Filter by custom tags
- **filter[has_activation_schedule]** (boolean)
  Filter promotions with scheduled activation
- **filter[has_deactivation_schedule]** (boolean)
  Filter promotions with scheduled deactivation
- **sort** (string)
  Sort promotions by one or more fields. Use '-' prefix for descending order.
  Available fields: name, last_used, created_at, updated_at
  Default: -updated_at


## Responses
### 200
Successful response

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

- **meta** (object)



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