POST coupon_services/check

Checks validity of specified coupon code and product area. Supported product areas: "Tickets", "TimedTickets", "Memberships". The response will include a list of effects the coupon can apply, a flag indicating whether coupon applications are limited and the maximum applications remaining if true. Each coupon effect will identify the product area and product code it applies to, coupon validity, expiry dates and effect type. Effect Types: "DiscountPercent" - Reduce price by percentage indicated in 'Amount' field, "DiscountAmount" - Reduce price by 'Amount' specified, "PriceOverride" - Replace listed price with 'Amount' specified and reveal product if hidden. If the coupon is not valid a reason will be included in the response. On the redemption of a coupon, the code should be included in the CouponCode field of every Ticket/Item object that the coupon has been applied to. Requires: HTTPS, Basic Auth (Ticket Services or Member Services area)

Request Information

Parameters

NameDescriptionAdditional information
coupon 
An object containing the coupon code as entered by the user and the product area in which it will be used. Valid product areas: "Tickets", "TimedTickets", "Memberships".

Define this parameter in the request body.

Request body formats

application/json, text/json

Sample: 
{
  "CouponCode": "sample string 1",
  "ProductArea": "sample string 2"
}

Response Information

Response body formats

application/json, text/json

Sample: 
{
  "CouponCode": "sample string 1",
  "LimitedUse": true,
  "UsesRemaining": 3,
  "ConditionForUse": "sample string 4",
  "CouponStockID": 5,
  "IsValidForNewMembership": true,
  "IsvalidForRenewMembership": true,
  "Effects": [
    {
      "Valid": true,
      "ProductType": "sample string 2",
      "ProductCode": 3,
      "EffectType": "sample string 4",
      "Amount": 5.0,
      "ReasonInvalid": "sample string 6",
      "ValidFrom": "2026-04-02T21:55:29.6765025-05:00",
      "ValidUntil": "2026-04-02T21:55:29.6765025-05:00",
      "WaiveTicketFee": true,
      "PackageID": 10
    },
    {
      "Valid": true,
      "ProductType": "sample string 2",
      "ProductCode": 3,
      "EffectType": "sample string 4",
      "Amount": 5.0,
      "ReasonInvalid": "sample string 6",
      "ValidFrom": "2026-04-02T21:55:29.6765025-05:00",
      "ValidUntil": "2026-04-02T21:55:29.6765025-05:00",
      "WaiveTicketFee": true,
      "PackageID": 10
    },
    {
      "Valid": true,
      "ProductType": "sample string 2",
      "ProductCode": 3,
      "EffectType": "sample string 4",
      "Amount": 5.0,
      "ReasonInvalid": "sample string 6",
      "ValidFrom": "2026-04-02T21:55:29.6765025-05:00",
      "ValidUntil": "2026-04-02T21:55:29.6765025-05:00",
      "WaiveTicketFee": true,
      "PackageID": 10
    }
  ]
}