Performing your first API call

Prerequisites

Before you begin, make sure:

• You are a Tiqets' approved distribution partner and have access to our portal. Sign up here.

• You've obtained a Distributor API Key.

• You have basic knowledge of working with RESTful APIs and JSON.

Please note that depending on your access level you'll be able to use different API endpoints.

Authentication

All API requests must include:

• "Authorization" header containing the Distributor API key. Authorization: Token [partner-api-key]

• "User-Agent" header containing any user agent of your choice, but preferably the name of your company or brand as this helps with debugging any issues later on "User-Agent: cool company X"

Note that both Authorization and User-Agent fields are required in the request

Example using cURL:

curl --request GET "https://api.tiqets.com/v2/products" \
--header "Accept: application/json" \
--header "User-Agent: my user agent" \
--header "Authorization: Token [partner-api-key]"

For more advanced endpoints such as the Booking API or the Product Change API we also request signing your requests in a secure way. Please make sure to refer to our guide on how to Sign your API requests to our standard. JWT Signing for Secure API Requests

Code Samples

Here are several examples to help you perform your first API call.

Make sure to update the code before running it by inserting your API Key.

Warning: The code samples below are meant for illustrative purposes only!

Please apply best practices in your final product, such as keeping secrets outside of the source code or version control systems.

NodeJS

const https = require('https');
const apiKey = '[partner-api-key]'; // Replace with your actual API key

const options = {
  hostname: 'api.tiqets.com',
  path: '/v2/products',
  method: 'GET',
  headers: {
    'Accept': 'application/json',
    'User-Agent': 'my user agent',
    'Authorization': `Token ${apiKey}`
  }
};

const req = https.request(options, res => {
  let data = '';
  res.on('data', chunk => data += chunk);
  res.on('end', () => console.log(data));
});

req.on('error', err => console.error(err));
req.end();

PHP

Python