{"info":{"_postman_id":"8a33a800-7d2c-48a2-a8ff-00a2fa095ed4","name":"Ticket Core API for Resellers","description":"

Welcome to the Ticket Core API documentation for Resellers. This API allows resellers to book tickets and retrieve ticketing information such as available dates, timeslots and ticket types. In this docs you will find details about the available endpoints, request and response formats, and usage examples.

Authentication

All API requests must include an API token in the Authorization header. The token is provided when you make a call to /token. Here is an example of how to include the token in your requests:

Authorization: Bearer YOUR_TOKEN\n\n

Best Practices

To ensure optimal performance, reduce load on the server, and maintain data freshness, please cache requests as follows:

Dates: Cache at least once a day.
\n
Ticket Types: Cache at least once a day.
\n
Timeslots: Cache one or two times a minute.
\n

Regularly refreshing cached data ensures that you have the most up-to-date information while minimizing the number of requests made to the server.

Support

If you have any questions or need further assistance, please contact our support team at support@ticketcore.nl.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"6856150","collectionId":"8a33a800-7d2c-48a2-a8ff-00a2fa095ed4","publishedId":"2sA3QtcW1R","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-05-28T12:29:45.000Z"},"item":[{"name":"Dates","id":"3e00d3f5-77ad-4e68-abdc-773e2c89d182","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer <>"}],"url":"https://reseller.ticketcore.nl/dates/2024-05","auth":{"type":"jwt","jwt":{"basicConfig":[{"key":"isSecretBase64Encoded","value":""},{"key":"algorithm","value":""},{"key":"payload","value":""},{"key":"addTokenTo","value":""},{"key":"headerPrefix","value":""},{"key":"queryParamKey","value":""},{"key":"header","value":"

"}]},"isInherited":true,"source":{"_postman_id":"8a33a800-7d2c-48a2-a8ff-00a2fa095ed4","id":"8a33a800-7d2c-48a2-a8ff-00a2fa095ed4","name":"Ticket Core API for Resellers","type":"collection"}},"urlObject":{"protocol":"https","path":["dates","2024-05"],"host":["reseller","ticketcore","nl"],"query":[],"variable":[]}},"response":[],"_postman_id":"3e00d3f5-77ad-4e68-abdc-773e2c89d182"},{"name":"Timeslots","id":"04556917-d124-4454-a6a6-46c8cca2241f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer <>"}],"url":"https://reseller.ticketcore.nl/timeslots/2024-05-28","auth":{"type":"jwt","jwt":{"basicConfig":[{"key":"isSecretBase64Encoded","value":""},{"key":"algorithm","value":""},{"key":"payload","value":""},{"key":"addTokenTo","value":""},{"key":"headerPrefix","value":""},{"key":"queryParamKey","value":""},{"key":"header","value":"

"}]},"isInherited":true,"source":{"_postman_id":"8a33a800-7d2c-48a2-a8ff-00a2fa095ed4","id":"8a33a800-7d2c-48a2-a8ff-00a2fa095ed4","name":"Ticket Core API for Resellers","type":"collection"}},"urlObject":{"protocol":"https","path":["timeslots","2024-05-28"],"host":["reseller","ticketcore","nl"],"query":[],"variable":[]}},"response":[],"_postman_id":"04556917-d124-4454-a6a6-46c8cca2241f"},{"name":"Tickettypes","id":"c1b41728-d8fe-4747-a9d2-c0bc587d81bc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer <>"}],"url":"https://reseller.ticketcore.nl/tickettypes/nl/2024-05-27","auth":{"type":"jwt","jwt":{"basicConfig":[{"key":"isSecretBase64Encoded","value":""},{"key":"algorithm","value":""},{"key":"payload","value":""},{"key":"addTokenTo","value":""},{"key":"headerPrefix","value":""},{"key":"queryParamKey","value":""},{"key":"header","value":"

"}]},"isInherited":true,"source":{"_postman_id":"8a33a800-7d2c-48a2-a8ff-00a2fa095ed4","id":"8a33a800-7d2c-48a2-a8ff-00a2fa095ed4","name":"Ticket Core API for Resellers","type":"collection"}},"urlObject":{"protocol":"https","path":["tickettypes","nl","2024-05-27"],"host":["reseller","ticketcore","nl"],"query":[],"variable":[]}},"response":[],"_postman_id":"c1b41728-d8fe-4747-a9d2-c0bc587d81bc"},{"name":"Request Token","event":[{"listen":"test","script":{"id":"748d10e0-453f-45aa-9c2a-8c5d8ef7698e","exec":["pm.test(\"Response contains the token field\", function () {"," pm.expect(pm.response.json()).to.have.property('token');","});",""],"type":"text/javascript","packages":{}}}],"id":"1b203c05-73fa-4435-a6e7-c093e29532d5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"api_user\": \"<>\",\n \"api_secret\": \"<>\"\n}","options":{"raw":{"language":"json"}}},"url":"https://reseller.ticketcore.nl/token","description":"

Request Description

This endpoint allows the user to obtain a token by making an HTTP POST request to the specified URL. The request body should be in raw JSON format and include the \"api_user\" and \"api_secret\" parameters.

Request Body

api_user (string): The API user's credentials.
\n
api_secret (string): The API user's secret key.
\n

Response

The response to this request is expected to be in JSON format. The response includes an expires_at field in UTC date format.

Note: The expiration time may vary over time. You can rely on the expires_at value provided in the response. For best practice, save the token and use it multiple times until the expires_at time is near. Excessive requests for new tokens will be blocked.

{\n  \"token\": \"...token...\",\n  \"expires_at\": \"DATE_IN_UTC_FORMAT\"\n}\n\n

\n","auth":{"type":"jwt","jwt":{"basicConfig":[{"key":"isSecretBase64Encoded","value":""},{"key":"algorithm","value":""},{"key":"payload","value":""},{"key":"addTokenTo","value":""},{"key":"headerPrefix","value":""},{"key":"queryParamKey","value":""},{"key":"header","value":"

"}]},"isInherited":true,"source":{"_postman_id":"8a33a800-7d2c-48a2-a8ff-00a2fa095ed4","id":"8a33a800-7d2c-48a2-a8ff-00a2fa095ed4","name":"Ticket Core API for Resellers","type":"collection"}},"urlObject":{"protocol":"https","path":["token"],"host":["reseller","ticketcore","nl"],"query":[],"variable":[]}},"response":[],"_postman_id":"1b203c05-73fa-4435-a6e7-c093e29532d5"},{"name":"Create Reservation","id":"ce2552b0-e800-466a-aef4-54735608316f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer <>"}],"body":{"mode":"raw","raw":"{\n \"language\": \"nl\",\n \"date\": \"2027-06-17\",\n \"timeslot\": \"12:00\",\n \"ticket_types\": [\n {\n \"id\": \"84f21c48-07c1-4d0b-9755-fc7c0bed2515\",\n \"quantity\": 2\n }\n ],\n \"visitor\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"john.doe@example.com\",\n \"country\": \"NL\"\n }\n}\n","options":{"raw":{"language":"json"}}},"url":"https://reseller.ticketcore.nl/reservation","description":"

Create Reservation Endpoint

The Create Reservation endpoint allows resellers to make a reservation for tickets on behalf of visitors.

Request

Endpoint

POST /reservation

Request Body

language (string, required): The language preference for the reservation.
\n
date (string, required): The date for the reservation in YYYY-MM-DD format.
\n
timeslot (string, required): The timeslot for the reservation in HH:MM format.
\n
ticket_types (array, required): An array of ticket types with their corresponding quantities. Each object in the array should contain:
\n
- id (string, required): The ID of the ticket type.
  \n
- quantity (integer, required): The quantity of tickets for the specified type.
  \n
\n
visitor (object, required/optional based on the museum): Details of the visitor making the reservation. This information is utilized by some museums to notify visitors in case of emergencies or assist them in locating their tickets.
\n
- first_name (string, required): The first name of the visitor.
  \n
- last_name (string, required): The last name of the visitor.
  \n
- email (string, required): The email address of the visitor.
  \n
- country (string, ISO 3166-1 alpha-2): The country code of the visitor (for example \"US\").
  \n
\n

Note: Please add the visitor details to enable our support team to assist the visitor effectively.

Response Status Codes

200 - Reservation Created: The reservation has been successfully created.
\n
400 - Bad Request: The request is invalid. For example, required fields are missing or incorrectly formatted.
\n

The Complete Reservation endpoint allows resellers to complete a reservation, converting it into a booking.

Request

Endpoint

POST /reservation/{ID}/complete

Parameters

ID: The reservation ID to be completed. This should be included in the URL path.

Response Status Codes

200 - Complete Success: The reservation has been successfully converted to a booking.
\n
400 - Bad Request: The request is invalid. For example, the reservation ID is missing or malformed.
\n
404 - Not Found: The specified reservation does not exist.
\n

Response Example

If you attempt to complete the reservation multiple times (e.g., accidentally), the reservation will only be completed once. However, for the first 15 minutes, the response will indicate a successful completion. After 15 minutes, attempting to complete the reservation again will result in an error message stating, 'The reservation is already completed.'

Note: Please save the barcodes and booking_id on your end.

{\n    \"booking_id\": 12345678,\n    \"language\": \"en\",\n    \"date\": \"2027-06-17\",\n    \"timeslot\": \"12:00\",\n    \"tickets\": [\n        {\n            \"ticket_type_id\": \"1cc69ac8-2027-4745-824f-572b8d85f097\",\n            \"ticket_type_name\": \"Adult\",\n            \"barcode\": \"1234567890123\"\n        },\n        {\n            \"ticket_type_id\": \"1cc69ac8-2027-4745-824f-572b8d85f097\",\n            \"ticket_type_name\": \"Adult\",\n            \"barcode\": \"1234567890124\"\n        }\n    ]\n}\n\n

With this endpoint, you can cancel a booking, which refers to a reservation that has already been completed. Note that cancellations are only allowed for bookings (tickets) with a future ticket date. Cancellation policies are determined by the individual museum.

Response Status Codes:

200 - Cancel Success: The booking has been successfully canceled.
\n
400 - Bad Request: The request is invalid. For example, the booking is not completed yet.
\n
404 - Not Found: The specified booking does not exist.
\n
409 - Conflict: The booking has already been canceled.
\n

"}]}},"event":[{"listen":"prerequest","script":{"id":"3127c2df-e5fd-45f7-8091-330f0298af7b","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"62c5e1aa-e3a5-49d2-8441-28db696492a5","type":"text/javascript","packages":{},"exec":[""]}}]}