Powered by TodayTix Agent APIs

For retailers or agents integrating with TodayTix Group APIs in order to access products and inventory from specific Powered by TodayTix shows and venues there's a subset of our APIs that can be used.

These allow you to:

1. Fetch dates, pricing and availability levels for a specific show
2. Hold seats (maximum hold times apply)
3. Complete a purchase
4. Fetch barcodes (where applicable)

Authentication

Information about availability and pricing can be fetched without authentication, however, to make a hold or purchase you will need to authenticate. More information on how to authenticate API calls can be found here.

Dates, Pricing and Availability

The inventory availability API gives an overview of performance dates, pricing and availability for a show for a specific period. It returns an array of objects, each object representing a performance.

The inventory areas API can then be used to fetch detailed inventory information for a specific performance. For each part of the venue (eg. dress circle), groups of seats are returned.

Holding Seats

The patch basket API is used to create or update a basket using the information from the areas API. You can also clear or delete a basket. More information on managing baskets can be found here.

🚧

Please note the maximum hold time for a basket is 8 minutes.

Complete a purchase

Once the basket is ready it can be confirmed using the post checkout API as well as the basket details you will also need to pass the lead booker information for the purchase. A booking reference and secret / checksum value will be returned on success. It's important to securely store these as they will be required to fetch the booking details.

Get booking status / fetch barcodes

To access details of the booking use the get bookings API using the secret from the completed checkout.

🚧

By default booking confirmation emails will automatically be sent for successful bookings unless a request is submitted via the Box Office to suppress these.