---
title: "Find all promocodes"
method: GET
path: "/coupons/{coupon_id}/promocodes.json"
tags: ["Promocode Endpoints"]
---

# Find all promocodes

`GET /coupons/{coupon_id}/promocodes.json`

Returns all promocodes

## Path parameters

- `coupon_id` integer, required

## Headers

- `Authorization` string, required

## Response `200`

successful operation

- 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

- **2025-01-13** (v2) `9331d0ba9538` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2022-05-08** (v2) `2a343eba9b87` — 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/:coupon_id/promocodes.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.dev/jammed-org/apis/jammed-bookings-api/revisions/8edf08285947?raw)