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
Default
null
page_size

Number of items per page

Type
integer
Default
50
page

Current page

Type
integer
Default
1
ticket_validfrom

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

Example"2027-01-01"
ticket_validuntil

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

Example"2027-01-01"
face_value

face_value for end-customer (cents). Operators, e.g. eq:10, ne:10, gt:10, ge:10, lt:10, le:10, in:[10,20], not_in:[10,20]

stock

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

venue_id

venue_id

Type
string
Examplenull
event_id

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

ticket_id

XS2Event ticket identifier. Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_tck, ne:2c2a9dc47e794e0ba88a6917e2b9047b_tck, in:[2c2a9dc47e794e0ba88a6917e2b9047b_tck,7d881550d5ba4cb2b3faca11a9b1695d_tck], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_tck,7d881550d5ba4cb2b3faca11a9b1695d_tck]

ticket_type

Enum: eticket, appticket, paper-ticket, collection-stadium, eticket_with_pickup, other. Operators, e.g. eq:eticket, ne:eticket, in:[eticket,other], not_in:[eticket,other]

ticket_status

Enum: available, disabled, error, returned, on_request, paused. Operators, e.g. eq:available, ne:available, in:[available,paused], not_in:[available,paused]

city

city

Type
string
Examplenull
supplier_type

Enum: eventpromotor, reseller, dataprovider, marketplace, hybrid. Operators, e.g. eq:eventpromotor, ne:eventpromotor, in:[eventpromotor,hybrid], not_in:[eventpromotor,hybrid]

supplier_id

supplier id. Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_spp, ne:2c2a9dc47e794e0ba88a6917e2b9047b_spp, in:[2c2a9dc47e794e0ba88a6917e2b9047b_spp,7d881550d5ba4cb2b3faca11a9b1695d_spp], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_spp,7d881550d5ba4cb2b3faca11a9b1695d_spp]

organiser_id

organiser id. Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_org, ne:2c2a9dc47e794e0ba88a6917e2b9047b_org, in:[2c2a9dc47e794e0ba88a6917e2b9047b_org,7d881550d5ba4cb2b3faca11a9b1695d_org], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_org,7d881550d5ba4cb2b3faca11a9b1695d_org]

category_id

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

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"
tournament_id

tournament id. Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_trn, ne:2c2a9dc47e794e0ba88a6917e2b9047b_trn, in:[2c2a9dc47e794e0ba88a6917e2b9047b_trn,7d881550d5ba4cb2b3faca11a9b1695d_trn], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_trn,7d881550d5ba4cb2b3faca11a9b1695d_trn]

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. Operators, e.g. eq:grandstand, ne:grandstand, in:[grandstand,extras], not_in:[grandstand,extras]

Example"grandstand"
show_deleted

show deleted tickets

Examplenull
Default
null
ticket_validity

Enum: singleday, twoday, other, weekend, fourday. Operators, e.g. eq:singleday, ne:singleday, in:[singleday,fourday], not_in:[singleday,fourday]

vat_category

Enum: high, low, middle, none, rc. Operators, e.g. eq:high, ne:high, in:[high,rc], not_in:[high,rc]

updated

Updated date or datetime to filter on (yyyy-mm-dd or yyyy-mm-ddThh:mm:ss). 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

created

Created date or datetime to filter on (yyyy-mm-dd or yyyy-mm-ddThh:mm:ss). 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

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": true,
  
  
  
"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": "string",
  
  
  
"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​