CouponCodes

Retrieve a coupon code

Returns a single CouponCode by ID, scoped to its parent Coupon. Use this to inspect a specific code's validity window or pre-allocation.

Requires the RESERVATIONS_VIEW permission on the coupon's site.

get/shop/coupons/{couponId}/codes/{couponCodeId}

Response

A single CouponCode.

Example response

{
  "data": {
    "id": "5f1234567890abcdef123456",
    "code": "SUMMER2026",
    "coupon_id": "5f1234567890abcdef123456",
    "valid_from_date": "2026-06-01T00:00:00Z",
    "valid_to_date": "2026-08-31T23:59:59Z",
    "customer_credit_id": "5f1234567890abcdef123456",
    "customer_id": "11111111-1111-1111-1111-111111111111",
    "revenue": 5000
  }
}

Changes