Start a ticket reservation. It’s possible to reserve multiple tickets in one call / reservation.


HMAC calculation
apiKey + environment + ticketDate + ticketTime + tickets + userId
Please note: optional fields only needs to be included when an optional field is used.


Name Datatype Description
apiKey String Your public apiKey needs to be included in every request.
environment Enum "test" or "production"
userId Integer The userId is a reference to the user (museum / attraction). The userId can be requested via getAvailableUsers and can be cached in your application.
Array with the tickets
Name Datatype
ticketTypeId Integer
ticketNumber Integer
ticketDate Date The ticket date must comply with the yyyy-mm-dd format.
ticketTime Time (optional) 24 hours format (hh:mm), this field is optional based on the user.
HMACKey String The HMACKey is calculated based on the input fields.


Name Datatype Description
success Boolean Indicates if the request was successfully executed.
reservationId Number The transactionId needs to be included in further requests (addContact and completeReservation / cancelReservation).
reservationValidUntil Datetime Expiration datetime of the reservation. Format: yyyy-mm-dd hh:mm:ss

JSON input example


JSON output example

   "reservationValidUntil":"2018-11-16 21:06:14"