---
title: "Find a coupon by ID"
method: GET
path: "/coupons/{id}.json"
tags: ["Coupon Endpoints"]
---

# Find a coupon by ID

`GET /coupons/{id}.json`

Returns coupon with the given ID

## Path parameters

- `id` integer, required

## 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
- `404` — Not found - Coupon was not found

---

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