Search K
Appearance
Get events
GET
/v1/events
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
nullpage_size
Number of items per page
Typeinteger
Default
50page
Current page
Typeinteger
Default
1sport_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
Typestring
Example
"soccer"tournament_type
Enum: cup, league, oneoff
Typestring
Example
"league"date_start
Event start date
Typestring
Example
"2024-04-01"date_stop
Event stop date
Typestring
Example
"2024-04-30"venue_id
Typestring
Example
"7552e5ca74124757be3f4b0dc1687aa9_vnx"event_id
Typestring
Example
"5d3b8b1c916f4a158dc736dc8ef7c97a_evt"tournament_id
Typestring
Example
"6652b082b6d64e92af2794fb1e352e86_trn"team_id
Typestring
Example
"3eae14a18975444a8af9d35f4e978f0e_tms"hometeam_id
Typestring
Example
"3eae14a18975444a8af9d35f4e978f0e_tms"visitingteam_id
Typestring
Example
"12c3564d227044f4a22ea29b3fe806fa_tms"city
Typestring
Example
"London"location_id
Events related to a specific location id (can be venue, city, ..)
Typestring
Example
"2326aaa6494c401ba94e8bf9c0b5de44_ddr"event_status
Enum: cancelled, closed, notstarted, nosale, postponed, soldout
Typestring
Example
"notstarted"country
Country in iso 3 format
Typestring
Example
"GBR"event_name
Typestring
Example
"Arsenal FC vs Luton Town"tournament_name
Typestring
Example
"Premier League"tickets_available
Number of tickets available for this event (on category level)
Typestring
Example
"gt:10"booked
Show only events which have had bookings
Typeboolean
Example
truepopular_events
Show all the popular events
Typeboolean
Example
falseticket_price_eur
Typestring
Example
"lt:100"slug
Seo friendly alternative to uuid
Typestring
Example
"arsenal-fc-vs-luton-town-5d3b8"accept_language
To localize an event in a specific name. Fallback to en
Typestring
Example
"en"season
Season, for example 2024 or 24/25 depending on sport type
Typestring
Example
"23/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": "soccer",
"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": [
{
"label": "Early Bird",
"date_start": "2024-06-01T00:00:00",
"date_stop": "2024-06-30T23:59:59"
}
],
"is_popular": true
}
],
"pagination": {
"total_size": 1,
"page_size": 50,
"page_number": 1,
"next_page": "string",
"previous_page": "string"
}
}