Getting Started
Overview
There are 5 steps to selling a ticket. This step by step guide below with examples will take you through the process:
1 - Decide which ticket
First, query the available tickets catalog to find a product that fits the needs. This is done using the /ticket/catalog/ endpoint.
Use the itemNumber to specify your chosen ticket in later steps.
2 - Find and select a time slot
Next we need to find time slots for the admission codes that are included with the selected product.
For that purpose we will use the /ticket/capacity/search endpoint.
From the response, user must select a suitable time slot. We need the code (“CASTLE”) and schedule.id (452)
values to be able to create the reservation in the next step.
3 - Create the reservation
To make a reservation we need to know the itemNumber (from step 1), admissionCode and scheduleId from step 2
If the reservation is successful, we will get a reservation token in return. As long as the reservation is valid, our tickets are guaranteed.
For subsequent references to this reservation we need the reservation token.
4 - Confirm the reservation
Tickets are reserved but not valid until the reservation has been confirmed. To confirm a reservation we use the /ticket/reservation/:token/confirm endpoint.
The response object contains the ticket numbers that are created and valid for admission.
5 - Ticket information
To get access to the ticket endpoint services, you need to know the ticketId - a unique id for each ticket. You can look-up the this id if you have printed barcode of the ticket with the Find Ticket service.
When the ticketId is know, use the Get Ticket endpoint to retrieve all ticket information.
The response contain all relevant ticket details: