Search K

Appearance

Get events ​

GET
/v1/events
Server

Get events. This endpoint is aimed for the standalone frontend

Authorizations​

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

Parameters​

Query Parameters

sorting
Typestring
default
page_size

Number of items per page

Typeinteger
default50
page

Current page

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

Typestring
Examplesoccer
tournament_type

Enum: cup, league, oneoff

Typestring
Exampleleague
date_start

Event start date

Typestring
Example2024-04-01
date_stop

Event stop date

Typestring
Example2024-04-30
venue_id
Typestring
Example7552e5ca74124757be3f4b0dc1687aa9_vnx
event_id
Typestring
Example5d3b8b1c916f4a158dc736dc8ef7c97a_evt
tournament_id
Typestring
Example6652b082b6d64e92af2794fb1e352e86_trn
team_id
Typestring
Example3eae14a18975444a8af9d35f4e978f0e_tms
hometeam_id
Typestring
Example3eae14a18975444a8af9d35f4e978f0e_tms
visitingteam_id
Typestring
Example12c3564d227044f4a22ea29b3fe806fa_tms
city
Typestring
ExampleLondon
location_id

Events related to a specific location id (can be venue, city, ..)

Typestring
Example2326aaa6494c401ba94e8bf9c0b5de44_ddr
event_status

Enum: cancelled, closed, notstarted, nosale, postponed, soldout

Typestring
Examplenotstarted
country

Country in iso 3 format

Typestring
ExampleGBR
event_name
Typestring
ExampleArsenal FC vs Luton Town
tournament_name
Typestring
ExamplePremier League
tickets_available

Number of tickets available for this event (on category level)

Typestring
Examplegt:10
booked

Show only events which have had bookings

Typeboolean
Exampletrue
popular_events

Show all the popular events

Typeboolean
Examplefalse
ticket_price_eur
Typestring
Examplelt:100
slug

Seo friendly alternative to uuid

Typestring
Examplearsenal-fc-vs-luton-town-5d3b8
accept_language

To localize an event in a specific name. Fallback to en

Typestring
Exampleen
season

Season, for example 2024 or 24/25 depending on sport type

Typestring
Example23/24

Responses​

OK
application/json
JSON
{
"events": [
{
"event_id": "5d3b8b1c916f4a158dc736dc8ef7c97a_evt",
"event_name": "Arsenal FC vs Luton Town",
"date_start": "2024-04-03T19:30:00",
"date_stop": "2024-04-03T21:15:00",
"event_status": "soldout",
"tournament_id": "6652b082b6d64e92af2794fb1e352e86_trn",
"tournament_name": "Premier League",
"venue_id": "7552e5ca74124757be3f4b0dc1687aa9_vnx",
"venue_name": "Emirates Stadium",
"location_id": "2326aaa6494c401ba94e8bf9c0b5de44_ddr",
"city": "London",
"iso_country": "GBR",
"latitude": "51.555",
"longitude": "-0.108611",
"sport_type": "string",
"season": "23/24",
"tournament_type": "league",
"date_confirmed": true,
"date_start_main_event": "2024-04-03T19:30:00+00:00",
"date_stop_main_event": "2024-04-03T21:15:00+00:00",
"hometeam_id": "3eae14a18975444a8af9d35f4e978f0e_tms",
"hometeam_name": "Arsenal FC",
"visiting_id": "12c3564d227044f4a22ea29b3fe806fa_tms",
"visiting_name": "Luton Town",
"created": "2023-06-16T07:08:25",
"updated": "2024-04-03T00:30:31",
"event_description": "Top of the table clash in London.",
"min_ticket_price_eur": 50,
"max_ticket_price_eur": 150,
"slug": "premier-league-arsenal-fc-vs-luton-town-2324-5d3b8",
"number_of_tickets": 50000,
"sales_periods": [
{
"date_start": "2024-06-01T00:00:00",
"date_stop": "2024-06-30T23:59:59",
"label": "Early Bird"
}
],
"is_popular": true
}
],
"pagination": {
"total_size": 1,
"page_size": 50,
"next_page": "string",
"previous_page": "string"
}
}

Samples​

cURL
curl -X GET \
'https://api.xs2event.com/v1/events?sport_type=soccer&tournament_type=league&date_start=2024-04-01&date_stop=2024-04-30&venue_id=7552e5ca74124757be3f4b0dc1687aa9_vnx&event_id=5d3b8b1c916f4a158dc736dc8ef7c97a_evt&tournament_id=6652b082b6d64e92af2794fb1e352e86_trn&team_id=3eae14a18975444a8af9d35f4e978f0e_tms&hometeam_id=3eae14a18975444a8af9d35f4e978f0e_tms&visitingteam_id=12c3564d227044f4a22ea29b3fe806fa_tms&city=London&location_id=2326aaa6494c401ba94e8bf9c0b5de44_ddr&event_status=notstarted&country=GBR&event_name=Arsenal+FC+vs+Luton+Town&tournament_name=Premier+League&tickets_available=gt%3A10&booked=true&popular_events=false&ticket_price_eur=lt%3A100&slug=arsenal-fc-vs-luton-town-5d3b8&accept_language=en&season=23%2F24' \
 -H "Content-Type: application/json"
JavaScript
fetch('https://api.xs2event.com/v1/events?sport_type=soccer&tournament_type=league&date_start=2024-04-01&date_stop=2024-04-30&venue_id=7552e5ca74124757be3f4b0dc1687aa9_vnx&event_id=5d3b8b1c916f4a158dc736dc8ef7c97a_evt&tournament_id=6652b082b6d64e92af2794fb1e352e86_trn&team_id=3eae14a18975444a8af9d35f4e978f0e_tms&hometeam_id=3eae14a18975444a8af9d35f4e978f0e_tms&visitingteam_id=12c3564d227044f4a22ea29b3fe806fa_tms&city=London&location_id=2326aaa6494c401ba94e8bf9c0b5de44_ddr&event_status=notstarted&country=GBR&event_name=Arsenal+FC+vs+Luton+Town&tournament_name=Premier+League&tickets_available=gt%3A10&booked=true&popular_events=false&ticket_price_eur=lt%3A100&slug=arsenal-fc-vs-luton-town-5d3b8&accept_language=en&season=23%2F24', {headers:{'Content-Type':'application/json'}})
  .then(response => response.json())
  .then(data => console.log(data));
PHP
<?php
$url = 'https://api.xs2event.com/v1/events';
$method = 'GET';
$headers = [
    'Content-Type' => 'application/json',
];
$query = http_build_query([
    'sport_type' => 'soccer',
    'tournament_type' => 'league',
    'date_start' => '2024-04-01',
    'date_stop' => '2024-04-30',
    'venue_id' => '7552e5ca74124757be3f4b0dc1687aa9_vnx',
    'event_id' => '5d3b8b1c916f4a158dc736dc8ef7c97a_evt',
    'tournament_id' => '6652b082b6d64e92af2794fb1e352e86_trn',
    'team_id' => '3eae14a18975444a8af9d35f4e978f0e_tms',
    'hometeam_id' => '3eae14a18975444a8af9d35f4e978f0e_tms',
    'visitingteam_id' => '12c3564d227044f4a22ea29b3fe806fa_tms',
    'city' => 'London',
    'location_id' => '2326aaa6494c401ba94e8bf9c0b5de44_ddr',
    'event_status' => 'notstarted',
    'country' => 'GBR',
    'event_name' => 'Arsenal FC vs Luton Town',
    'tournament_name' => 'Premier League',
    'tickets_available' => 'gt:10',
    'booked' => 'true',
    'popular_events' => 'false',
    'ticket_price_eur' => 'lt:100',
    'slug' => 'arsenal-fc-vs-luton-town-5d3b8',
    'accept_language' => 'en',
    'season' => '23/24',
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url . '?' . $query);
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/events'
params = {
    'sport_type': 'soccer',
    'tournament_type': 'league',
    'date_start': '2024-04-01',
    'date_stop': '2024-04-30',
    'venue_id': '7552e5ca74124757be3f4b0dc1687aa9_vnx',
    'event_id': '5d3b8b1c916f4a158dc736dc8ef7c97a_evt',
    'tournament_id': '6652b082b6d64e92af2794fb1e352e86_trn',
    'team_id': '3eae14a18975444a8af9d35f4e978f0e_tms',
    'hometeam_id': '3eae14a18975444a8af9d35f4e978f0e_tms',
    'visitingteam_id': '12c3564d227044f4a22ea29b3fe806fa_tms',
    'city': 'London',
    'location_id': '2326aaa6494c401ba94e8bf9c0b5de44_ddr',
    'event_status': 'notstarted',
    'country': 'GBR',
    'event_name': 'Arsenal FC vs Luton Town',
    'tournament_name': 'Premier League',
    'tickets_available': 'gt:10',
    'booked': true,
    'popular_events': false,
    'ticket_price_eur': 'lt:100',
    'slug': 'arsenal-fc-vs-luton-town-5d3b8',
    'accept_language': 'en',
    'season': '23/24'
}
headers = {
    'Content-Type': 'application/json'
}

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