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 plans column lists the plans that include the operation for the leagues they cover; Free plans carry the Standard datasets. A plan outside the list receives 403 with meta.msg = Endpoint not available for your plan.
t |
Operation | Required | Optional | Plans |
|---|---|---|---|---|
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, bookmaker_ids, utc, lang, odds_format, page |
All plans |
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, bookmaker_ids, utc, lang, odds_format |
All plans |
round |
Fixtures by round. Every match of a round, optionally narrowed to a team. | round_id |
team_id, include, bookmaker_ids, utc, lang, odds_format |
All plans |
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 |
All plans |
tv |
Fixtures by TV channel. Matches scheduled on a TV channel over the next two weeks. | tv_id |
include, bookmaker_ids, utc, lang |
Standard, World Cup, Broadcast |
info |
Match by ID. One match with teams, league, venue, scores, status and clock. | id |
include, bookmaker_ids, utc, lang, odds_format |
All plans |
sort |
Matches by multiple IDs. Several matches in one request, for example to refresh the matches shown on screen. | ids |
include, bookmaker_ids, utc, lang |
All plans |
match_events |
Match events. Standalone event timeline of one match. | id |
— | Standard, World Cup |
match_lineups |
Match lineups. Formations and starting lineups with position and shirt number. | id |
lang |
Standard, World Cup |
match_bench |
Match bench. Substitutes of both teams with shirt number and position. | id |
— | Standard, World Cup |
match_comments |
Match commentary. Text commentary of the match where covered. | id |
lang |
Standard, World Cup |
match_sidelined |
Match sidelined players. Injured and suspended players of both teams. | id |
— | Standard, World Cup |
match_odds |
Pre-match odds. Pre-match odds by bookmaker and market. | id |
odds_format |
Standard, World Cup, Odds |
match_oddsinplay |
In-play odds. Live odds by market and bookmaker, with the score and minute they refer to. | id |
odds_format |
Standard, World Cup, Odds |
match_odds_info |
Match odds by bookmaker. Odds history of one bookmaker for the match, by market. | id, bookmaker_id |
odds_format |
Standard, World Cup, Odds |
Includes
Comma-separated dataset names for include, without spaces:
events: match timeline; supported byschedule,season,round,infoandsort— Standard, World Cup plansstats: team match statistics, one entry per team — Standard, World Cup plansbroadcast: TV channels showing the match — Standard, World Cup, Broadcast plansodds_prematch: pre-match odds — Standard, World Cup, Odds plansodds_inplay: in-play odds for matches in play — Standard, World Cup, Odds plans
With include=odds_prematch, include=odds_inplay or both, use bookmaker_ids to select bookmakers and control their order within each market's bookmakers array. Pass comma-separated IDs without spaces: bookmaker_ids=9,2 returns only bookmakers 9 and 2, in that order; bookmaker_ids=9,3,1 uses the order 9, 3, 1; bookmaker_ids=2 selects just bookmaker 2. Returned odds remain subject to match and market coverage.
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/?api_key=API_KEY&t=schedule&d=2026-08-30&include=broadcast&utc=2
Fixtures by date with pre-match odds from bookmakers 9, 3 and 1, in that order:
GET /v2.2/fixtures/?api_key=API_KEY&t=schedule&d=2026-08-30&include=odds_prematch&bookmaker_ids=9,3,1
Fixtures by season:
GET /v2.2/fixtures/?api_key=API_KEY&t=season&season_id=7194&team_id=111&order=asc
Fixtures by round:
GET /v2.2/fixtures/?api_key=API_KEY&t=round&round_id=1994
Team last and next fixtures:
GET /v2.2/fixtures/?api_key=API_KEY&t=last_next&team_id=99
Fixtures by TV channel:
GET /v2.2/fixtures/?api_key=API_KEY&t=tv&tv_id=30
Match by ID:
GET /v2.2/fixtures/?api_key=API_KEY&t=info&id=2589310&include=events,stats
Match by ID with pre-match and in-play odds from bookmaker 2 only:
GET /v2.2/fixtures/?api_key=API_KEY&t=info&id=2589310&include=odds_prematch,odds_inplay&bookmaker_ids=2
Matches by multiple IDs:
GET /v2.2/fixtures/?api_key=API_KEY&t=sort&ids=2589310,2589313&include=events
Match events:
GET /v2.2/fixtures/?api_key=API_KEY&t=match_events&id=2589310
Match lineups:
GET /v2.2/fixtures/?api_key=API_KEY&t=match_lineups&id=2589310&include=stats
Match bench:
GET /v2.2/fixtures/?api_key=API_KEY&t=match_bench&id=2589310
Match commentary:
GET /v2.2/fixtures/?api_key=API_KEY&t=match_comments&id=2589310
Match sidelined players:
GET /v2.2/fixtures/?api_key=API_KEY&t=match_sidelined&id=2589310
Pre-match odds:
GET /v2.2/fixtures/?api_key=API_KEY&t=match_odds&id=2589310
In-play odds:
GET /v2.2/fixtures/?api_key=API_KEY&t=match_oddsinplay&id=2589310
Match odds by bookmaker:
GET /v2.2/fixtures/?api_key=API_KEY&t=match_odds_info&id=2589310&bookmaker_id=1