Search K

Appearance

Get categories ​

GET
/v1/categories
Server

Get categories

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
venue_id
Typestring
Example3fa6eb7f123a4f5ab2c9d8e7a6b7c9d0_ven
event_id
Typestring
Exampledd82ecd6931749819942c4aff9dd23cb_evt
supplier_id
Typestring
Example7acfed7b0d874c5e870b531e5a4f0e43_spp
sport_type

Enum: soccer, motorsport, tennis, rugby, darts, horseracing, boxing, other, motogp, formula1, cricket, basketball, combatsport, icehockey, nba, nfl, mlb, watersport, dtm, indycar, superbike, padel

Typestring
Examplesoccer
country
Typestring
ExampleNL
venue_name
Typestring
ExampleJuventus Stadium
category_name
Typestring
ExampleOmar Sivori Club
on_svg
Typestring
Exampletrue
category_id
Typestring
Example7df2fbc7f06e4985be92fb263b1f9c63_ctg
highlight_type
Typestring
Examplexs2event_choice
slug
Typestring
Exampleomar-sivori-club

Responses​

OK
application/json
JSON
{
"categories": [
{
"category_name": "Omar Sivori Club",
"category_id": "7df2fbc7f06e4985be92fb263b1f9c63_ctg",
"venue_id": "3fa6eb7f123a4f5ab2c9d8e7a6b7c9d0_ven",
"sport_type": "string",
"venue_name": "Juventus Stadium",
"created": "2024-04-08T14:03:00",
"on_svg": true,
"description": {
"nl_NL": "De Omar Sivori Club biedt hospitality service van hoog niveau...",
"en_GB": "The Omar Sivori Club offers high-level hospitality service.",
"de_DE": "Der Omar Sivori Club bietet Hospitality-Service auf höchstem Niveau.",
"fr_FR": "Le Club Omar Sivori offre un service d'hospitalité de haut niveau.",
"es_ES": "El Club Omar Sivori ofrece un servicio de hospitalidad de alto nivel.",
"it_IT": "Il Club Omar Sivori offre un servizio di ospitalità di alto livello.",
"da_DK": "Omar Sivori Club tilbyder hospitality-service på højt niveau.",
"pt_PT": "O Clube Omar Sivori oferece um serviço de hospitalidade de alto nível.",
"cn_CN": "奥马尔·西沃里俱乐部提供高水平的接待服务。",
"ko_KO": "오마르 시보리 클럽은 최고 수준의 환대 서비스를 제공합니다.",
"ja_JA": "オマール・シヴォリ・クラブは高水準のホスピタリティサービスを提供します。",
"ar_AE": "يقدم نادي عمر سيفوري خدمة ضيافة عالية المستوى。",
"zh_Hans_CN": "奥马尔·西沃里俱乐部提供高水平的接待服务。",
"sv_SE": "Omar Sivori-klubben erbjuder en gästfrihetstjänst på hög nivå"
},
"options": {
"videowall": true,
"covered_seat": false,
"numbered_seat": true
},
"category_type": "grandstand",
"ticket_delivery_days": 2,
"party_size_together": 4,
"distribution_channel": "xs2event",
"highlight_type": "xs2event_choice",
"files": [
{
"category_id": "7df2fbc7f06e4985be92fb263b1f9c63_ctg",
"information_filename": "info.pdf"
}
],
"sports_enabled": [
"soccer"
],
"sports_disabled": [
"rugby",
"tennis"
]
}
],
"pagination": {
"total_size": 1,
"page_size": 50,
"next_page": "string",
"previous_page": "string"
}
}

Samples​

cURL
curl -X GET \
'https://api.xs2event.com/v1/categories?venue_id=3fa6eb7f123a4f5ab2c9d8e7a6b7c9d0_ven&event_id=dd82ecd6931749819942c4aff9dd23cb_evt&supplier_id=7acfed7b0d874c5e870b531e5a4f0e43_spp&sport_type=soccer&country=NL&venue_name=Juventus+Stadium&category_name=Omar+Sivori+Club&on_svg=true&category_id=7df2fbc7f06e4985be92fb263b1f9c63_ctg&highlight_type=xs2event_choice&slug=omar-sivori-club' \
 -H "Content-Type: application/json"
JavaScript
fetch('https://api.xs2event.com/v1/categories?venue_id=3fa6eb7f123a4f5ab2c9d8e7a6b7c9d0_ven&event_id=dd82ecd6931749819942c4aff9dd23cb_evt&supplier_id=7acfed7b0d874c5e870b531e5a4f0e43_spp&sport_type=soccer&country=NL&venue_name=Juventus+Stadium&category_name=Omar+Sivori+Club&on_svg=true&category_id=7df2fbc7f06e4985be92fb263b1f9c63_ctg&highlight_type=xs2event_choice&slug=omar-sivori-club', {headers:{'Content-Type':'application/json'}})
  .then(response => response.json())
  .then(data => console.log(data));
PHP
<?php
$url = 'https://api.xs2event.com/v1/categories';
$method = 'GET';
$headers = [
    'Content-Type' => 'application/json',
];
$query = http_build_query([
    'venue_id' => '3fa6eb7f123a4f5ab2c9d8e7a6b7c9d0_ven',
    'event_id' => 'dd82ecd6931749819942c4aff9dd23cb_evt',
    'supplier_id' => '7acfed7b0d874c5e870b531e5a4f0e43_spp',
    'sport_type' => 'soccer',
    'country' => 'NL',
    'venue_name' => 'Juventus Stadium',
    'category_name' => 'Omar Sivori Club',
    'on_svg' => 'true',
    'category_id' => '7df2fbc7f06e4985be92fb263b1f9c63_ctg',
    'highlight_type' => 'xs2event_choice',
    'slug' => 'omar-sivori-club',
]);

$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/categories'
params = {
    'venue_id': '3fa6eb7f123a4f5ab2c9d8e7a6b7c9d0_ven',
    'event_id': 'dd82ecd6931749819942c4aff9dd23cb_evt',
    'supplier_id': '7acfed7b0d874c5e870b531e5a4f0e43_spp',
    'sport_type': 'soccer',
    'country': 'NL',
    'venue_name': 'Juventus Stadium',
    'category_name': 'Omar Sivori Club',
    'on_svg': 'true',
    'category_id': '7df2fbc7f06e4985be92fb263b1f9c63_ctg',
    'highlight_type': 'xs2event_choice',
    'slug': 'omar-sivori-club'
}
headers = {
    'Content-Type': 'application/json'
}

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