---
title: "Find a promocode by ID"
method: GET
path: "/coupons/{coupon_id}/promocodes/{id}.json"
tags: ["Promocode"]
---

# Find a promocode by ID

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

## Request

- Base URL: `https://api.jammed.app/api/v2`
- URL: `https://api.jammed.app/api/v2/coupons/{coupon_id}/promocodes/{id}.json`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/jammed-org/apis/jammed-bookings-api/docs/coupons/:coupon_id/promocodes/:id.json/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a single promocode of the coupon, with how many times it has been used.

Requires the `bookings.read` scope when using OAuth tokens.

## Path parameters

- `coupon_id` integer, required
- `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
  - `redemption_limit` integer, nullable: How many times the promocode can be used in total. `null` means there is no limit
  - `number_of_times_used` integer: How many times the promocode has been used. A redemption on a booking that was cancelled before it was confirmed no longer counts
  - `fully_used` boolean: Is set as true once `number_of_times_used` has reached the `redemption_limit`

## Other responses

- `401`: Unauthorized - Invalid API key
- `403`: Forbidden - the OAuth token lacks the `bookings.read` scope
- `404`: Not found - the coupon or promocode was not found

## Changes

- **2026-11-07** (v2) `954c4af8fc83`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/jammed-org/apis/jammed-bookings-api/changes/coupons/:coupon_id/promocodes/:id.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/954c4af8fc83?raw)