---
search:
  tags:
    - Promotions
    - GET
seo:
  description: >-
    Returns discount promotions. Promotions apply percentage or fixed-amount
    discounts via… Reference for the GET /promotions endpoint in the Bolder API
    v2.
sidebar:
  label: List promotions
  badge: GET
title: List promotions
type: openapi-operation
---
Returns discount promotions. Promotions apply percentage or
fixed-amount discounts via coupon codes or automatic rules.

`GET /promotions`

**Responses**

- `200` — Paginated promotions list
- `403` — Access denied
- `422` — \`shop\_id\` required

Response example, 200:

```json
{
  "_class": [
    "results",
    "promotions"
  ],
  "total_items": 1,
  "per_page": 20,
  "page": 1,
  "_links": {
    "self": {
      "href": "https://api.onbolder.com/v2/promotions?shop_id=1"
    }
  },
  "_embedded": {
    "items": [
      {
        "id": 20,
        "name": "Summer Sale 20%",
        "code": "SUMMER20",
        "activation_mode": "code",
        "discount_type": "percentage",
        "discount": 20,
        "status": "active",
        "starts_at": "2024-06-01T00:00:00Z",
        "expires_at": "2024-08-31T23:59:59Z",
        "_links": {
          "self": {
            "href": "https://api.onbolder.com/v2/promotions/20"
          }
        }
      }
    ]
  }
}
```