---
search:
  tags:
    - Volume Discounts
    - GET
seo:
  description: >-
    Returns volume discount rules. Volume discounts automatically apply tiered
    pricing… Reference for the GET /volume_discounts endpoint in the Bolder API
    v2.
sidebar:
  label: List volume discounts
  badge: GET
title: List volume discounts
type: openapi-operation
---
Returns volume discount rules. Volume discounts automatically
apply tiered pricing when a customer orders above a quantity threshold.

`GET /volume_discounts`

**Responses**

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

Response example, 200:

```json
{
  "_class": [
    "results",
    "volume_discounts"
  ],
  "total_items": 1,
  "per_page": 20,
  "page": 1,
  "_links": {
    "self": {
      "href": "https://api.onbolder.com/v2/volume_discounts?shop_id=1"
    }
  },
  "_embedded": {
    "items": [
      {
        "id": 30,
        "name": "Buy 5+ get 10% off",
        "discount_type": "percentage",
        "tiers": {
          "5": 10,
          "10": 15
        },
        "_links": {
          "self": {
            "href": "https://api.onbolder.com/v2/volume_discounts/30"
          }
        }
      }
    ]
  }
}
```
