Appearance

Get events ​

GET
/v1/events

Get events. This endpoint is aimed for the standalone frontend

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

Enum: cup, league, oneoff. Operators, e.g. eq:cup, ne:cup, in:[cup,oneoff], not_in:[cup,oneoff]

Example"league"
date_start

Event start date. 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"2026-12-01"
date_stop

Event stop date. 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"2026-12-31"
venue_id

Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_vnx, ne:2c2a9dc47e794e0ba88a6917e2b9047b_vnx, in:[2c2a9dc47e794e0ba88a6917e2b9047b_vnx,7d881550d5ba4cb2b3faca11a9b1695d_vnx], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_vnx,7d881550d5ba4cb2b3faca11a9b1695d_vnx]

Example"7552e5ca74124757be3f4b0dc1687aa9_vnx"
event_id

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

Example"5d3b8b1c916f4a158dc736dc8ef7c97a_evt"
tournament_id

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

Example"6652b082b6d64e92af2794fb1e352e86_trn"
team_id

Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_tms, ne:2c2a9dc47e794e0ba88a6917e2b9047b_tms, in:[2c2a9dc47e794e0ba88a6917e2b9047b_tms,7d881550d5ba4cb2b3faca11a9b1695d_tms], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_tms,7d881550d5ba4cb2b3faca11a9b1695d_tms]

Example"3eae14a18975444a8af9d35f4e978f0e_tms"
hometeam_id

Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_tms, ne:2c2a9dc47e794e0ba88a6917e2b9047b_tms, in:[2c2a9dc47e794e0ba88a6917e2b9047b_tms,7d881550d5ba4cb2b3faca11a9b1695d_tms], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_tms,7d881550d5ba4cb2b3faca11a9b1695d_tms]

Example"3eae14a18975444a8af9d35f4e978f0e_tms"
visitingteam_id

Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_tms, ne:2c2a9dc47e794e0ba88a6917e2b9047b_tms, in:[2c2a9dc47e794e0ba88a6917e2b9047b_tms,7d881550d5ba4cb2b3faca11a9b1695d_tms], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_tms,7d881550d5ba4cb2b3faca11a9b1695d_tms]

Example"12c3564d227044f4a22ea29b3fe806fa_tms"
city

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

Example"London"
location_id

Events related to a specific location (address) id. Operators, e.g. eq:2c2a9dc47e794e0ba88a6917e2b9047b_ddr, ne:2c2a9dc47e794e0ba88a6917e2b9047b_ddr, in:[2c2a9dc47e794e0ba88a6917e2b9047b_ddr,7d881550d5ba4cb2b3faca11a9b1695d_ddr], not_in:[2c2a9dc47e794e0ba88a6917e2b9047b_ddr,7d881550d5ba4cb2b3faca11a9b1695d_ddr]

Example"2326aaa6494c401ba94e8bf9c0b5de44_ddr"
event_status

Enum: cancelled, closed, notstarted, nosale, postponed, soldout. Operators, e.g. eq:cancelled, ne:cancelled, in:[cancelled,soldout], not_in:[cancelled,soldout]

Example"notstarted"
country

Country in iso 3 format

Example"GBR"
event_name
Type
string
Example"Arsenal FC vs Luton Town"
tournament_name

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

Example"Premier League"
tickets_available

Number of tickets available for this event (on category level). Operators, e.g. eq:10, ne:10, gt:10, ge:10, lt:10, le:10, between:10,20

Example"gt:10"
booked

Show only events which have had bookings

Type
boolean
Exampletrue
popular_events

Show all the popular events

Type
boolean
Examplefalse
ticket_price_eur

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

Example"lt:100"
slug

Seo friendly alternative to uuid

Type
string
Example"arsenal-fc-vs-luton-town-5d3b8"
accept_language

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

Type
string
Example"en"
season

Season, for example 2026 or 25/26 depending on sport type

Example"25/26"
updated

Updated date/datetime to filter on (e.g. ge:2026-12-01 or 2026-12-01T12:00:00). 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"ge:2026-12-01"
created

Created date/datetime to filter on (e.g. ge:2026-12-01 or 2026-12-01T12:00:00). 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"ge:2026-12-01"

Responses​

OK

application/json
JSON
{
  
"events": [
  
  
{
  
  
  
"event_id": "5d3b8b1c916f4a158dc736dc8ef7c97a_evt",
  
  
  
"event_name": "Arsenal FC vs Luton Town",
  
  
  
"date_start": "2026-12-15T19:30:00",
  
  
  
"date_stop": "2026-12-15T21: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": "25/26",
  
  
  
"tournament_type": "league",
  
  
  
"date_confirmed": true,
  
  
  
"has_sprint_race": false,
  
  
  
"date_start_main_event": "2026-12-15T19:30:00+00:00",
  
  
  
"date_stop_main_event": "2026-12-15T21:15:00+00:00",
  
  
  
"hometeam_id": "3eae14a18975444a8af9d35f4e978f0e_tms",
  
  
  
"hometeam_name": "Arsenal FC",
  
  
  
"visiting_id": "12c3564d227044f4a22ea29b3fe806fa_tms",
  
  
  
"visiting_name": "Luton Town",
  
  
  
"performer_id": "0f1e2d3c4b5a69788796a5b4c3d2e1f0_prf",
  
  
  
"created": "2026-12-01T07:08:25",
  
  
  
"updated": "2026-12-01T00: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": [
  
  
  
  
"string"
  
  
  
],
  
  
  
"is_popular": true,
  
  
  
"date_visibility": "show_datetime"
  
  
}
  
],
  
"pagination": {
  
  
"total_size": 1,
  
  
"page_size": 50,
  
  
"page_number": 1,
  
  
"next_page": "string",
  
  
"previous_page": "string"
  
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​