Skip to content

Get category

GET
/v1/categories/{category_id}
Server

Get a single category based on a given id

Authorizations

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

Parameters

Path Parameters

category_id*

XS2event ID of the Category

Typestring
Required

Responses

OK
application/json
JSON
{
"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"
]
}

Samples

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

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
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/{category_id}'

headers = {
    'Content-Type': 'application/json'
}

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