Scan API (1.0)

This function allows you to get the status of a barcode (valid / invalid) and information about the ticket(s).

HMACKey: Base64 encode - SHA256(apiKey + barcodeNumber)

This function allows you to set the barcode (ticket) status to “checked in”.

HMACKey: Base64 encode - SHA256(apiKey + barcodeNumber)

With this functionality you can retrieve the availability of a specified article (ticket type).

Note: This function only returns tickettypes that have been made available for sale through API.

HMACKey: Base64 encode - SHA256(apiKey + ticketTypeId + ticketDate*)

With this functionality you can create a reservation. Create a reservation for a single ticket type, or for multiple ticket types by sending the tickets object.

Note: Reservations are by default valid for 15 minutes. Please use “reservationValidUntil” to prevent errors at the completeReservation method.

HMACKey:

• Single ticket type: not documented
• Multiple ticket types: Base64 encode - SHA256(apiKey + ticketDate + tickets)

HMAC calculation of the tickets array

Sort the entries by ticketTypeId ascending and the keys within each entry alphabetically, then concatenate the values. Example (PHP):

$tickets = [
  '321' => [ 'ticketNumber' => 2, 'ticketTime' => '10:00' ],
  '123' => [ 'ticketTime' => '12:00', 'ticketNumber' => 3 ],
];

// sorted and concatenated:
$result = '123312:00321210:00';

With this functionality you can update a reservation. Update a reservation for a single ticket type, or for multiple ticket types by sending the tickets object.

HMACKey:

• Single ticket type: Base64 encode - SHA256(apiKey + reservationId + ticketTypeId + ticketNumber + ticketDate + ticketTime)
• Multiple ticket types: Base64 encode - SHA256(apiKey + reservationId + ticketDate + tickets)

HMAC calculation of the tickets array

Sort the entries by ticketTypeId ascending and the keys within each entry alphabetically, then concatenate the values. Example (PHP):

$tickets = [
  '321' => [ 'ticketNumber' => 2, 'ticketTime' => '10:00' ],
  '123' => [ 'ticketTime' => '12:00', 'ticketNumber' => 3 ],
];

// sorted and concatenated:
$result = '123312:00321210:00';

With this functionality you can complete an earlier made reservation. The output contains the barcodes of the reservation.

HMACKey: Base64 encode - SHA256(apiKey + reservationId + scanTicket*)

With this functionality you can cancel an earlier created reservation. Please note that you can only cancel a completed reservation.

HMACKey: Base64 encode - SHA256(apiKey + reservationId)

With this functionality you can force release the reserved capacity for a reservation. Please note that this is only possible for pending reservations and will not cancel the reservation. You can use the cancelReservation endpoint for this.

HMACKey: Base64 encode - SHA256(apiKey + reservationId)

With this functionality you can retrieve the ticket types that have been made available for sale through API.

Note: This function only shows tickettypes that have been made available for sale through API.

HMACKey: Base64 encode - SHA256(apiKey)

With this function you can retrieve the turnover, discount and the number of tickets sold during a selected period. Use the startDate and endDate parameters to select a period.

Note: The maximum period per request is restricted to one month.

HMACKey: Base64 encode - SHA256(apiKey + startDate + endDate)

With this function you can retrieve the Groups and Education reservations for a specific date.

HMACKey: Base64 encode - SHA256(apiKey + date + language)