Booking API

These endpoints allow you to perform bookings and manage your orders.

Access to Booking API

Except for the List Orders endpoint, all other Booking API Endpoints require a special permission. To obtain access, please contact your account manager.

Booking order flow

Booking process

Create order

Order creation results in a reservation of a chosen set of tickets for a specific date and timeslot (if applicable) which will be held for 30 minutes. Therefor only create an order (reservation) when it is (almost) certain that the order will be confirmed too. If you are processing payments with your customer, please do so after creating the order and before confirming the order.

⚠️ Reservation is not a guarantee!

Tiqets is connected to many different booking platforms of our suppliers. Many of those don't support holding tickets or tickets are held less than 30 minutes. To reduce the risk of failing an order after payment, Tiqets uses different mitigation strategies, depending on the characteristics of the product. We may, for example, consider a product sold-out if the remaining number of tickets is so low that odds are high that they are sold out within a short period of time.

Request Signing

The request to create an order must be signed.

See the Request Signing section in this document for information on how to do this.

Potentially required: additional checkout information

Many products require specific customer data when creating an order. The requires_visitors_details field returned by the Availability endpoint provides this information.

Please make sure your user interface allows users to provide the required details. Providing fake customer data may result in your account being suspended.

Confirm order

Once an order is confirmed, the process of obtaining the tickets and generating the PDF will start.

The request to confirm an order must be signed. See the section regarding Request Signing below.

• Call the 'Confirm Order' endpoint and include the payment_confirmation_token

• The order should be confirmed before it is expired

⚠️ Do not retry order confirmation because it will become invalid once the order has expired.

Retrieve tickets

Once an order has the status done, the order is fulfilled and the tickets are ready and can be retrieved.

To retrieve the tickets, call the 'Get Tickets' endpoint. If the order process has finished, the response will contain the URL to the PDF tickets under the tickets_pdf_url field.

Please note that you cannot make any alterations to the PDF tickets. The venues expect the guests to present their vouchers in the format as Tiqets makes them available. Any alterations to the vouchers (as well as extracting the barcode or QR code to use them in a different context) are therefore not allowed since this might lead to the venue rejecting the guest due to an invalid ticket and therefore a bad guest experience.

Flow chart