v11

latestOpenAPI 3.1.12026-08-03174162.0 MB

Coupons

Update a coupon

put/coupons/{id}

Path parameters

idstring required

Unique identifier of the coupon to update

Example:cpn_01jps5cgsfzs1ksqaet5hba8ac

Request body

couponIdstring

Duplicate of id field for GSI queries.

namestring

Internal label for the coupon, visible to event organisers.

activeboolean

Whether this coupon is currently active.

showHiddenboolean

Whether this coupon reveals hidden admissions and sections within its scope.

kind'AMOUNT' | 'PERCENT'

Type of discount this coupon gives: a fixed amount or a percentage.

filter'TEAM' | 'PROMOTER' | 'EVENTS' | 'SECTIONS' | 'ADMISSIONS'

Scope of the coupon. TEAM applies to all events in the team. PROMOTER applies to all events by specified promoters. EVENTS/SECTIONS/ADMISSIONS apply to specific items.

currency'AED' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BZD' | 'CAD' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MNT' | 'MOP' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SRD' | 'SVC' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XOF' | 'XPF' | 'ZAR' | 'ZMW' | 'ZWL' nullable

Three-letter ISO 4217 currency code for transactions and payouts

discountnumber

The discount value. If kind is 'amount', this is a currency amount. If kind is 'percent', this is a percentage.

limitnumber

Maximum number of times the coupon can be redeemed across all customers.

usesnumber

Number of times this coupon has been redeemed so far.

saleStartsAtstring

Wall clock time when this coupon becomes valid (no timezone, ISO 8601 format: YYYY-MM-DDTHH:mm:ss)

saleEndsAtstring nullable

Wall clock time without timezone (displays same everywhere)

Example request

{
  "couponId": "cpn_01jps5cgsfzs1ksqaet5hba8ac",
  "name": "Half Price",
  "active": true,
  "kind": "PERCENT",
  "filter": "EVENTS",
  "currency": "AUD",
  "discount": 50,
  "limit": -1,
  "saleStartsAt": "2025-02-10T03:00:00"
}

Response

Example response

{
  "coupon": {
    "id": "cpn_01jps5cgsfzs1ksqaet5hba8ac",
    "couponId": "cpn_01jps5cgsfzs1ksqaet5hba8ac",
    "createdAt": "2026-08-03T06:13:52.214Z",
    "updatedAt": "2026-08-03T06:13:52.214Z",
    "name": "Half Price",
    "active": true,
    "kind": "PERCENT",
    "filter": "EVENTS",
    "currency": "AUD",
    "discount": 50,
    "limit": -1,
    "saleStartsAt": "2025-02-10T03:00:00"
  }
}