List available inventory items
Returns a paginated list of the inventory an occurrence lists for sale, plus any sold-out area kept on display (see the end of this description). Use the inventoryVariant._type field to differentiate between item types:
AssignedSeat— specific physical seat (section, row, seat number)GeneralAdmission— general admission area with available quantityExtra— an add-on such as drinks, merchandise or parkingGiftCard— a gift card. Most gift-card events return one item per denomination, each carrying the balance it is issued with invalue. An event whose buyer chooses the amount returns oneGiftCarditem instead, carryingvalueRangeandpresetValuesand novalue; a cart for it must send the chosen amount asgiftCard.value. A gift-card event’s occurrence and venue are placeholders: do not render a date, a time or a venue for one.
InventoryVariant.id is stable across all occurrences, enabling seating chart integration.
Send the quantity query parameter to shape the list around a party of that size; omit it to see all inventory. Most inventory the party cannot buy is dropped. A seat the party can pick carries selectionGroup.inventoryItemIds: the items to add to the cart together when the customer picks it. A seat that is in stock but not sold to a party of that size stays listed with selectionBlocked.chainSize, the quantity that would work. A listed seat with neither field cannot be picked at that size, for example because taking it would strand a single seat. Show both as unavailable and do not add them to a cart. Pagination applies to the shaped list, so fetch every page with the same quantity.
While the inventory does not change, items come back in the same order on every request, so the pages of one list fit together. A seat that sells between page requests shifts the items after it.
Send the voucherCode query parameter with a presale or access code to include the inventory sold only to holders of that code.
A GeneralAdmission area that has sold out but is configured to stay listed is returned with quantityAvailable 0 and an empty priceOptions, after every purchasable item. Show it as unavailable; it cannot be added to a cart.
Authentication
Path parameters
Headers
Query parameters
Optional rate code: prices this request at a pricing tier your TTG contact set up for you (see Rate Codes). Omit it for the default tier; a code not set up for this event and retailer is rejected with a 404 naming the code.
ISO 4217 currency to price in. Omit for the event base currency. A currency this event is not sold in returns 400; one it is sold in but that cannot be priced right now returns 503.
Number of tickets the party needs. Seats the whole party can sit in together carry a selectionGroup; seats in stock but not sold at that size carry selectionBlocked; general admission areas without enough tickets remaining are dropped. Omit to see all inventory.
Presale or access code the shopper has entered. Inventory sold only to holders of this code is included and priced with the code applied. A code this event does not recognize is ignored: the response is the same as without it. A blank code, or one longer than 15 characters, is rejected with a 400.
Optional extras to add to the response, comma-separated. IMAGES gives every assigned seat images: the views of the stage from that seat, empty for a seat with none. Leave out an extra the page does not display; each one adds to the response time. An unknown value is rejected with a 400.