Fixtures
Fixture lists by date, season, round, team or TV channel, single match details and the per-match datasets: events, lineups, bench, commentary, sidelined players and odds. Match-returning operations accept include to embed datasets in the match objects.
Open in the interactive reference
Operations
- GETFixtures by date — Matches on a date, optionally narrowed to a country, league, season, stage, group or round. Paginated, 100 items per page.
- GETFixtures by season — Every match of a season in one response, optionally narrowed to a stage, group or team.
- GETFixtures by round — Every match of a round, optionally narrowed to a team.
- GETTeam last and next fixtures — Recent results (
last), matches in play (current) and upcoming matches (next) of a team. Does not acceptinclude. - GETFixtures by TV channel — Matches scheduled on a TV channel over the next two weeks.
- GETMatch by ID — One match with teams, league, venue, scores, status and clock.
- GETMatches by multiple IDs — Several matches in one request, for example to refresh the matches shown on screen.
- GETMatch events — Standalone event timeline of one match.
- GETMatch lineups — Formations and starting lineups with position and shirt number.
- GETMatch bench — Substitutes of both teams with shirt number and position.
- GETMatch commentary — Text commentary of the match where covered.
- GETMatch sidelined players — Injured and suspended players of both teams.
- GETPre-match odds — Pre-match odds by bookmaker and market.
- GETIn-play odds — Live odds by market and bookmaker, with the score and minute they refer to.
- GETMatch odds by bookmaker — Odds history of one bookmaker for the match, by market.
Route reference
Operations
The t query parameter selects the operation. Parameters not listed for an operation are ignored. The theme column marks datasets that themed plans (Odds, Broadcast) include only for their own theme; Free and Standard plans include every theme for their leagues.
t |
Operation | Required | Optional | Theme |
|---|---|---|---|---|
schedule |
Fixtures by date. Matches on a date, optionally narrowed to a country, league, season, stage, group or round. Paginated, 100 items per page. | d |
country_id, league_id, season_id, stage_id, group_id, round_id, include, utc, lang, odds_format, page |
core |
season |
Fixtures by season. Every match of a season in one response, optionally narrowed to a stage, group or team. | season_id |
stage_id, group_id, team_id, include, utc, lang, odds_format |
core |
round |
Fixtures by round. Every match of a round, optionally narrowed to a team. | round_id |
team_id, include, utc, lang, odds_format |
core |
last_next |
Team last and next fixtures. Recent results (last), matches in play (current) and upcoming matches (next) of a team. Does not accept include. |
team_id |
utc, lang |
core |
tv |
Fixtures by TV channel. Matches scheduled on a TV channel over the next two weeks. | tv_id |
include, utc, lang |
broadcast |
info |
Match by ID. One match with teams, league, venue, scores, status and clock. | id |
include, utc, lang, odds_format |
core |
sort |
Matches by multiple IDs. Several matches in one request, for example to refresh the matches shown on screen. | ids |
include, utc, lang |
core |
match_events |
Match events. Standalone event timeline of one match. | id |
— | core |
match_lineups |
Match lineups. Formations and starting lineups with position and shirt number. | id |
lang |
core |
match_bench |
Match bench. Substitutes of both teams with shirt number and position. | id |
— | core |
match_comments |
Match commentary. Text commentary of the match where covered. | id |
lang |
core |
match_sidelined |
Match sidelined players. Injured and suspended players of both teams. | id |
— | core |
match_odds |
Pre-match odds. Pre-match odds by bookmaker and market. | id |
odds_format |
odds |
match_oddsinplay |
In-play odds. Live odds by market and bookmaker, with the score and minute they refer to. | id |
odds_format |
odds |
match_odds_info |
Match odds by bookmaker. Odds history of one bookmaker for the match, by market. | id, bookmaker_id |
odds_format |
odds |
Includes
Comma-separated dataset names for include, without spaces:
events: match timeline; supported byschedule,season,round,infoandsortstats: team match statistics, one entry per teambroadcast: TV channels showing the match (broadcast theme)odds_prematch: pre-match odds (odds theme)odds_inplay: in-play odds for matches in play (odds theme)
The release notes announce include=stats on match_lineups for per-player statistics; verification on 2026-09-04 returned no extra data, so it is not documented as a parameter. The order parameter shown in the public reference has no effect either. The match-detail operation is t=info; match_by_id is not a valid value and /v2.2/matches/ is not a v2.2 route. Dataset names such as events belong in include; match_events is an operation, not an include value. IDs can be JSON numbers or numeric strings depending on the operation: treat them as opaque and normalize before strict comparisons.
Examples
Fixtures by date:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=schedule&d=2026-08-30&include=broadcast&utc=2
Fixtures by season:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=season&season_id=7194&team_id=111&order=asc
Fixtures by round:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=round&round_id=1994
Team last and next fixtures:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=last_next&team_id=99
Fixtures by TV channel:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=tv&tv_id=30
Match by ID:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=info&id=2589310&include=events,stats
Matches by multiple IDs:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=sort&ids=2589310,2589313&include=events
Match events:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_events&id=2589310
Match lineups:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_lineups&id=2589310&include=stats
Match bench:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_bench&id=2589310
Match commentary:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_comments&id=2589310
Match sidelined players:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_sidelined&id=2589310
Pre-match odds:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_odds&id=2589310
In-play odds:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_oddsinplay&id=2589310
Match odds by bookmaker:
GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_odds_info&id=2589310&bookmaker_id=1