Skip to content

Get tickets a supplier can manage

GET
/v1/suppliers/{supplier_id}/tickets

List tickets for the authenticated supplier (supplier role). Admins and mcp_internal may also access.

Authorizations

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

Parameters

Path Parameters

supplier_id*

XS2event ID of the Supplier

Type
string
Required

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

Type
string
hometeam_id
Type
string
visitingteam_id
Type
string
tournament_id
Type
string
event_id

Filter tickets by event(s)

Type
string
ticket_validfrom

Ticket valid-from date filter (YYYY-MM-DD)

Type
string
ticket_validuntil

Ticket valid-until date filter (YYYY-MM-DD)

Type
string
event_startdate

Event start date (YYYY-MM-DD)

Type
string
event_stopdate

Event stop date (YYYY-MM-DD)

Type
string
latestsale_date
Type
string
is_relisted_ticket
Type
string
show_deleted
Type
string

Responses

OK

application/json
JSON
{
  
"events": [
  
  
{
  
  
  
"event_id": null,
  
  
  
"date_start": null,
  
  
  
"date_stop": null,
  
  
  
"date_confirmed": null,
  
  
  
"event_status": null,
  
  
  
"tournament_id": null,
  
  
  
"hometeam_id": null,
  
  
  
"hometeam_name": null,
  
  
  
"visiting_id": null,
  
  
  
"visiting_name": null,
  
  
  
"tournament_name": null,
  
  
  
"venue_name": null,
  
  
  
"venue_id": null,
  
  
  
"location_id": null,
  
  
  
"city": null,
  
  
  
"iso_country": null,
  
  
  
"latitude": null,
  
  
  
"longitude": null,
  
  
  
"sport_type": null,
  
  
  
"created": null,
  
  
  
"updated": null,
  
  
  
"event_name": null,
  
  
  
"season": null,
  
  
  
"tournament_type": null,
  
  
  
"event_description": null,
  
  
  
"slug": null,
  
  
  
"categories": [
  
  
  
  
{
  
  
  
  
  
"category_id": null,
  
  
  
  
  
"ticket_id": null,
  
  
  
  
  
"external_ticket_id": null,
  
  
  
  
  
"ticket_title": null,
  
  
  
  
  
"type_ticket": "eticket",
  
  
  
  
  
"ticket_status": null,
  
  
  
  
  
"ticket_validfrom": null,
  
  
  
  
  
"ticket_validuntil": null,
  
  
  
  
  
"ticket_validity": null,
  
  
  
  
  
"category_type": null,
  
  
  
  
  
"sub_category": null,
  
  
  
  
  
"organiser_price": null,
  
  
  
  
  
"organiser_vat": null,
  
  
  
  
  
"xs2event_price": null,
  
  
  
  
  
"xs2event_vat": null,
  
  
  
  
  
"supplier_quantity": null,
  
  
  
  
  
"currency_code": null,
  
  
  
  
  
"event_id": null,
  
  
  
  
  
"supplier_id": null,
  
  
  
  
  
"xs2event_stock": null,
  
  
  
  
  
"net_rate": null,
  
  
  
  
  
"created": null,
  
  
  
  
  
"updated": null,
  
  
  
  
  
"supplier_terms": null,
  
  
  
  
  
"category_information_available": null,
  
  
  
  
  
"last_modified": null,
  
  
  
  
  
"supplier_role": null,
  
  
  
  
  
"discount_percentage": null,
  
  
  
  
  
"disable_reason_code": 100,
  
  
  
  
  
"event_name": null,
  
  
  
  
  
"pairs_only": null,
  
  
  
  
  
"backorder_quantity": null,
  
  
  
  
  
"available_quantity": null,
  
  
  
  
  
"organiser_id": null,
  
  
  
  
  
"last_checked": null,
  
  
  
  
  
"ticket_source": null,
  
  
  
  
  
"xs2event_price_eur": null,
  
  
  
  
  
"organiser_price_eur": null,
  
  
  
  
  
"ticket_targetgroup": null,
  
  
  
  
  
"countries_disabled": [
  
  
  
  
  
  
"string"
  
  
  
  
  
],
  
  
  
  
  
"countries_enabled": [
  
  
  
  
  
  
"string"
  
  
  
  
  
],
  
  
  
  
  
"distributors_disabled": [
  
  
  
  
  
  
"string"
  
  
  
  
  
],
  
  
  
  
  
"distributors_enabled": [
  
  
  
  
  
  
"string"
  
  
  
  
  
],
  
  
  
  
  
"vat_category": null,
  
  
  
  
  
"number_of_tickets_sold": null,
  
  
  
  
  
"number_of_bookingorders": null,
  
  
  
  
  
"package_rate": null,
  
  
  
  
  
"service_fee": null,
  
  
  
  
  
"service_feevat": null,
  
  
  
  
  
"cost_price_eur": null,
  
  
  
  
  
"cost_price": null,
  
  
  
  
  
"face_value_eur": null,
  
  
  
  
  
"face_value": null,
  
  
  
  
  
"sales_price_eur": null,
  
  
  
  
  
"sales_price": null,
  
  
  
  
  
"flags": [
  
  
  
  
  
  
"string"
  
  
  
  
  
],
  
  
  
  
  
"ticket_delivery_days": null,
  
  
  
  
  
"ticket_yield": {
  
  
  
  
  
  
"yield_strategy": "auto",
  
  
  
  
  
  
"yield_min_price": 10000,
  
  
  
  
  
  
"yield_max_price": 50000,
  
  
  
  
  
  
"currency_code": "EUR",
  
  
  
  
  
  
"diff_from_cheapest": 0,
  
  
  
  
  
  
"enabled": false,
  
  
  
  
  
  
"enabled_supplier_ids": [
  
  
  
  
  
  
  
"string"
  
  
  
  
  
  
],
  
  
  
  
  
  
"disabled_supplier_ids": [
  
  
  
  
  
  
  
"string"
  
  
  
  
  
  
],
  
  
  
  
  
  
"minimum_different_suppliers": 1
  
  
  
  
  
}
  
  
  
  
}
  
  
  
]
  
  
}
  
],
  
"pagination": {
  
  
"total_size": 1,
  
  
"page_size": 50,
  
  
"page_number": 1,
  
  
"next_page": "string",
  
  
"previous_page": "string"
  
}
}

Playground

Server
Authorization
Variables
Key
Value

Samples