Appearance

Get categories ​

GET
/v1/categories

Get categories

Authorizations​

api_key
Type
API Key (header: X-Api-Key)

Parameters​

Query Parameters

sorting
Default
null
page_size

Number of items per page

Type
integer
Default
50
page

Current page

Type
integer
Default
1
venue_id

Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_vnx, ne:2c2a9dc47e794e0ba88a6917e2b9047b_vnx, in:[2c2a9dc47e794e0ba88a6917e2b9047b_vnx,7d881550d5ba4cb2b3faca11a9b1695d_vnx], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_vnx,7d881550d5ba4cb2b3faca11a9b1695d_vnx]

Example"3fa6eb7f123a4f5ab2c9d8e7a6b7c9d0_ven"
event_id

Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_gnr, ne:2c2a9dc47e794e0ba88a6917e2b9047b_gnr, in:[2c2a9dc47e794e0ba88a6917e2b9047b_gnr,7d881550d5ba4cb2b3faca11a9b1695d_gnr], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_gnr,7d881550d5ba4cb2b3faca11a9b1695d_gnr]

Example"dd82ecd6931749819942c4aff9dd23cb_evt"
supplier_id
Type
string
Example"7acfed7b0d874c5e870b531e5a4f0e43_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, handball, golf, rowing, cycling, sailing, music. Operators, e.g. eq:soccer, ne:soccer, in:[soccer,music], not_in:[soccer,music]

Example"soccer"
country

Operators, e.g. eq:NLD, ne:NLD, gt:NLD, ge:NLD, lt:NLD, le:NLD, in:[NLD,BEL], not_in:[NLD,BEL]

Example"NL"
venue_name
Type
string
Example"Juventus Stadium"
category_name
Type
string
Example"Omar Sivori Club"
on_svg
Exampletrue
category_id

Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_ctg, ne:2c2a9dc47e794e0ba88a6917e2b9047b_ctg, in:[2c2a9dc47e794e0ba88a6917e2b9047b_ctg,7d881550d5ba4cb2b3faca11a9b1695d_ctg], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_ctg,7d881550d5ba4cb2b3faca11a9b1695d_ctg]

Example"7df2fbc7f06e4985be92fb263b1f9c63_ctg"
highlight_type

Enum: xs2event_choice. Operators, e.g. eq:xs2event_choice, ne:xs2event_choice, in:[xs2event_choice,xs2event_choice], not_in:[xs2event_choice,xs2event_choice]

Example"xs2event_choice"
category_type

Enum: grandstand, generaladmission, busparking, carparking, camping, transfer, hospitality, offsite_hospitality, extras. Operators, e.g. eq:grandstand, ne:grandstand, in:[grandstand,extras], not_in:[grandstand,extras]

Example"grandstand"
slug
Type
string
Example"omar-sivori-club"
updated

Operators, e.g. eq:2026-01-01, ne:2026-01-01, gt:2026-01-01, ge:2026-01-01, lt:2026-01-01, le:2026-01-01, between:2026-01-01,2026-02-01

Examplenull
created

Operators, e.g. eq:2026-01-01, ne:2026-01-01, gt:2026-01-01, ge:2026-01-01, lt:2026-01-01, le:2026-01-01, between:2026-01-01,2026-02-01

Examplenull
archived_since

Archived date/datetime to filter on (e.g. ge:2025-01-01). Implies archived categories are included. Operators, e.g. eq:2026-01-01, ne:2026-01-01, gt:2026-01-01, ge:2026-01-01, lt:2026-01-01, le:2026-01-01, between:2026-01-01,2026-02-01

Examplenull
show_deleted
Default
false
show_archived

If true, include archived categories

Default
false

Responses​

OK

application/json
JSON
{
  
"categories": [
  
  
{
  
  
  
"category_name": "Omar Sivori Club",
  
  
  
"category_id": "7df2fbc7f06e4985be92fb263b1f9c63_ctg",
  
  
  
"venue_id": "3fa6eb7f123a4f5ab2c9d8e7a6b7c9d0_ven",
  
  
  
"sport_type": "soccer",
  
  
  
"venue_name": "Juventus Stadium",
  
  
  
"created": "2025-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,
  
  
  
  
"package_rate": false,
  
  
  
  
"open_hours_before_match": 2,
  
  
  
  
"open_during_half_time": true,
  
  
  
  
"open_hours_after_match": 1,
  
  
  
  
"open_minutes_before_match": 30,
  
  
  
  
"open_minutes_after_match": 45
  
  
  
},
  
  
  
"deleted": "2025-04-08T14:03:00",
  
  
  
"archived_since": "2025-04-08T14:03:00",
  
  
  
"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": [
  
  
  
  
"string"
  
  
  
],
  
  
  
"sports_disabled": [
  
  
  
  
"string"
  
  
  
]
  
  
}
  
],
  
"pagination": {
  
  
"total_size": 1,
  
  
"page_size": 50,
  
  
"page_number": 1,
  
  
"next_page": "string",
  
  
"previous_page": "string"
  
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​