---
title: "Find all coupons"
method: GET
path: "/coupons.json"
tags: ["Coupon Endpoints"]
---

# Find all coupons

`GET /coupons.json`

Returns all coupons

## Headers

- `Authorization` string, required

## Response `200`

successful operation

- Coupon[]
  - `id` integer
  - `name` string — A label for the coupon - this is seen by your customers
  - `discount_type` string — The type of discount the coupon gives Either: 'fixed_amount' or 'percentage'
  - `amount` integer — The integer decimal amount, or percentage that the coupon will deduct. For `discount_type=percentage`, `10` would mean 10% For `discount_type=fixed_amount`, `10` would mean $0.10 or £0.10 etc
  - `all_new_customers` boolean — Set to true if you want the coupon to apply to all new customers automatically
  - `expires_at` string — The ISO8601 timestamp when the coupon expires. If not set, the coupon will never expire
  - `created_at` string — The ISO8601 timestamp when the coupon was created
  - `fully_used` boolean — Is set as true if the coupon has been used up, and cannot be used anymore
  - `expired` boolean — Is set as true if the coupon has expired
  - `status` string — The status of the coupon: `active`, `deleted`, `expired`, `fully used`
  - `duration` string — The duration of the coupon: `once`, `forever` If `forever`, the coupon can be used over and over by the same customer If `once`, the coupon can only be used once by the same customer
  - `total_number_of_uses` integer — The total number of times the coupon can be used
  - `number_of_times_used` integer — The number of times the coupon has been used
  - `promocodes` object[] — The promocodes that are linked to this coupon.
    - `coupon` Promocode
      - `id` integer
      - `code` string — The code the customer can use to redeem the promocode, they enter this code when booking. The code is case-insensitive and must be unique
      - `minimum_booking_value` integer — The minimum booking value the Promocode can be used for. If attempted for a booking below this value, the Coupon will not be applied
      - `first_time_use_only` boolean — If set to true, the Promocode will only be usable once per customer - applies to logged in customers only

## Other responses

- `401` — Unauthorized - Invalid API key

## Changes

- **2022-05-06** (v2) `c0668e260bdb` — 1 breaking
  - the `items/amount` response's property type/format changed from `string`/`` to `integer`/`` for status `200`
- **2022-05-06** (v2) `e09b5fb757b2` — 3 info
  - added the optional property `items/duration` to the response with the `200` status
  - added the optional property `items/number_of_times_used` to the response with the `200` status
  - added the optional property `items/total_number_of_uses` to the response with the `200` status
- **2022-05-05** (v2) `38fea9f46439` — 1 info
  - endpoint added
- **2022-05-05** (v2) `95c52cb13f9a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/jammed-org/apis/jammed-bookings-api/changes/coupons.json/get.md)

---

[API](https://skmtc.dev/jammed-org/apis/jammed-bookings-api.md) · [All operations](https://skmtc.dev/jammed-org/apis/jammed-bookings-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jammed-org/jammed-bookings-api/revisions/8edf08285947/schema)