Tiers

A tier defines the different types of ticket that can be purchased.

Changing the coupon, variant, option and date parameters may affect the response values for each tier.

FieldDescription
idThe unique id for the tier
serialAn auto-incrementing integer that will uniquely identify this tier within the product.
weightDefines the order in which variants should be displayed.
nameThe title or name of the tier.
descriptionA short paragraph explaining who this tier is intended for or what it includes.
sizeThe number of people this tier covers. Typically this will be 1 but could be more for Family Tickets for example.
weightDefines the order in which the tiers should be displayed.
currencyThe product currency, which is brought through for convenience.
priceThe price of this tier for an individual ticket given the supplied parameters.
availableWhether this tier is available to purchase by default or not.
minimumThe minimum number of tickets of this type that can be purchased in a single booking.
limitWhat is the maximum number of tickets that can be purchased with this tier for an individual booking.
sizeThe maximum number of people permitted for a given option with this tier. Basically, this means: tier.size * tickets.count < tier.capacity
thresholdAn integer value indicating how many spaces for an option need to be sold before this tier becomes available.
countThe maximum number of times this ticket is allowed to be scanned. A null value would indicate unlimited
noticeAn ISO8601 time period indicating how long before an option is due to start before this tier becomes unavailable for purchase.
periodAn ISO8601 time period indicating how long before an option is due to start before this tier becomes available for purchase.
intervalAn ISO8601 time period indicating how long must be left between scanning this type of ticket.
durationHow long this ticket would be valid for from the start of the option it is purchased for.
Language