Search K

Appearance

Get tickets ​

GET
/v1/tickets
Server

Gets a list with tickets for a specific event. Filters can optionally be applied

Authorizations​

api_key
TypeAPI Key (header: X-Api-Key)

Parameters​

Query Parameters

sorting
Typestring
default
page_size

Number of items per page

Typeinteger
default50
page

Current page

Typeinteger
default1
ticket_validfrom

ticket_validfrom (yyyy-mm-dd)

Typestring
Example
ticket_validuntil

ticket_validuntil (yyyy-mm-dd)

Typestring
Example
face_value

face_value for end-customer

Typestring
Example
stock

available stock

Typestring
Example
venue_id

venue_id

Typestring
Example
event_id

event_id

Typestring
Example
ticket_type

Enum: eticket, appticket, paper-ticket, collection-stadium, other

Typestring
Example
ticket_status

Enum: available, disabled, error, returned

Typestring
Example
city

city

Typestring
Example
supplier_type

supplier type

Typestring
Example
supplier_id

supplier id

Typestring
Example
organiser_id

organiser id

Typestring
Example
category_id

category id

Typestring
Example
sub_category

sub category such as sun_regular or weekend_youth

Typestring
Example
category_type

Enum: grandstand, generaladmission, busparking, carparking, camping, transfer, hospitality, extras

Typestring
Example
ticket_source

Enum: marketplace, external, xs2event

Typestring
Example
is_relisted_ticket

is relisted ticket

Typestring
Example
show_deleted

show deleted tickets

Typestring
Example
ticket_validity

Enum: singleday, twoday, other, weekend, fourday

Typestring
Example
vat_category

Enum: high, low, middle, none

Typestring
Examplehigh

Responses​

OK
application/json
JSON
{
"tickets": [
{
"flags": [
"no_max_minus_1"
],
"type_ticket": "string",
"ticket_status": "string",
"ticket_validity": "string",
"category_type": "grandstand",
"category_information_available": true,
"net_rate": 40000,
"face_value": 40000,
"event_id": "5d3b8b1c916f4a158dc736dc8ef7c97a_evt",
"description_supplier": "",
"information_shipping": "E - tickets will be sent four working days prior to event. <strong>Emergency 24hrs contact number +44 (0) 7779 259 561</strong>",
"currency_code": "GBP",
"ticket_validuntil": "2024-04-03T21:15:00",
"ticket_validfrom": "2024-04-03T19:30:00",
"min_order": 0,
"stock": 10,
"supplier_id": "869bb9c67e2941f78de7649a8fada871_spp",
"external_ticket_id": "10903",
"ticket_id": "7263883361d3411b8a85eb3a8f5c7988_tck",
"category_id": "f6b124c00e4c4b26954ee08ed9bf2840_ctg",
"ticket_title": "Cannon Club Level with Gallery Hospitality",
"ticket_targetgroup": "string",
"sub_category": "singleday_regular",
"category_name": "Cannon Club Level with Gallery Hospitality",
"created": "2023-06-17T09:02:32",
"updated": "2024-04-03T09:00:22",
"supplier_terms": "https://www.xs2event.com/general-terms-XS2Event_v1.4.pdf",
"supplier_role": "reseller",
"eventdays": "singleday",
"is_xs2event_supplier": false,
"options": "string",
"sales_periods": "string",
"local_rates": {
"package_rate": false,
"net_rate_eur": 5000,
"face_value_eur": 6000
},
"vat_category": "string"
}
],
"pagination": {
"total_size": 1,
"page_size": 50,
"next_page": "string",
"previous_page": "string"
}
}

Samples​

cURL
curl -X GET \
'https://api.xs2event.com/v1/tickets?vat_category=high' \
 -H "Content-Type: application/json"
JavaScript
fetch('https://api.xs2event.com/v1/tickets?vat_category=high', {headers:{'Content-Type':'application/json'}})
  .then(response => response.json())
  .then(data => console.log(data));
PHP
<?php
$url = 'https://api.xs2event.com/v1/tickets';
$method = 'GET';
$headers = [
    'Content-Type' => 'application/json',
];
$query = http_build_query([
    'vat_category' => 'high',
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url . '?' . $query);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
Python
import requests

url = 'https://api.xs2event.com/v1/tickets'
params = {
    'vat_category': 'high'
}
headers = {
    'Content-Type': 'application/json'
}

response = requests.get(url, params=params, headers=headers)
print(response.json())