Search K

Appearance

Get tickets ​

GET
/v1/tickets

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

Authorizations​

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

Parameters​

Query Parameters

sorting
Type
string
Default
null
page_size

Number of items per page

Type
integer
Default
50
page

Current page

Type
integer
Default
1
ticket_validfrom

ticket_validfrom (yyyy-mm-dd)

Type
string
Examplenull
ticket_validuntil

ticket_validuntil (yyyy-mm-dd)

Type
string
Examplenull
face_value

face_value for end-customer

Type
string
Examplenull
stock

available stock

Type
string
Examplenull
venue_id

venue_id

Type
string
Examplenull
event_id

event_id

Type
string
Examplenull
ticket_id

XS2Event ticket identifier. Supports exact id or in:[id1,id2] syntax.

Type
string
Example"7263883361d3411b8a85eb3a8f5c7988_tck"
ticket_type

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

Type
string
Examplenull
ticket_status

Enum: available, disabled, error, returned, on_request

Type
string
Examplenull
city

city

Type
string
Examplenull
supplier_type

supplier type

Type
string
Examplenull
supplier_id

supplier id

Type
string
Examplenull
organiser_id

organiser id

Type
string
Examplenull
category_id

category id

Type
string
Examplenull
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

Type
string
Valid values
"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"
Examplenull
tournament_id

tournament id

Type
string
Examplenull
sub_category

sub category such as sun_regular or weekend_youth

Type
string
Examplenull
category_type

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

Type
string
Examplenull
show_deleted

show deleted tickets

Type
string
Examplenull
ticket_validity

Enum: singleday, twoday, other, weekend, fourday

Type
string
Examplenull
vat_category

Enum: high, low, middle, none, rc

Type
string
Example"high"
updated

Updated datetime to filter on, as string with optional operator prefix (e.g. ge:2025-01-01 or 2025-01-01T12:00:00)

Type
string
Examplenull
created

Created datetime to filter on, as string with optional operator prefix (e.g. ge:2025-01-01 or 2025-01-01T12:00:00)

Type
string
Examplenull
include_youth

Include youth/children tickets. Excluded by default.

Examplenull
Default
null

Responses​

OK

application/json
JSON
{
  
"tickets": [
  
  
{
  
  
  
"flags": [
  
  
  
  
"string"
  
  
  
],
  
  
  
"type_ticket": "eticket",
  
  
  
"ticket_status": "disabled",
  
  
  
"ticket_validity": "singleday",
  
  
  
"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": "2025-04-03T21:15:00",
  
  
  
"ticket_validfrom": "2025-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": "regular",
  
  
  
"sub_category": "singleday_regular",
  
  
  
"category_name": "Cannon Club Level with Gallery Hospitality",
  
  
  
"created": "2025-06-17T09:02:32",
  
  
  
"updated": "2025-04-03T09:00:22",
  
  
  
"supplier_terms": "https://www.xs2event.com/general-terms-XS2Event_v1.4.pdf",
  
  
  
"supplier_role": "reseller",
  
  
  
"eventdays": "singleday",
  
  
  
"is_xs2event_supplier": null,
  
  
  
"options": {
  
  
  
  
"pairs_only": false,
  
  
  
  
"videowall": false,
  
  
  
  
"covered_seat": false,
  
  
  
  
"numbered_seat": false,
  
  
  
  
"customer_details_required": ""
  
  
  
},
  
  
  
"sales_periods": [
  
  
  
],
  
  
  
"local_rates": {
  
  
  
  
"package_rate": false,
  
  
  
  
"net_rate_eur": 5000,
  
  
  
  
"face_value_eur": 6000
  
  
  
},
  
  
  
"vat_category": null,
  
  
  
"disable_reason_code": 100
  
  
}
  
],
  
"pagination": {
  
  
"total_size": 1,
  
  
"page_size": 50,
  
  
"page_number": 1,
  
  
"next_page": "string",
  
  
"previous_page": "string"
  
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​