Documentation / Subjects
Fixtures, sports data API
FixturesWhat is coming, by date, with the ids to follow it into results the moment it is played.
Fixtures lists upcoming events with their start time in UTC, the competition and both sides. Send date for one day; leave it out for what is next. Each fixture keeps its id when it is played, so the same id that was a fixture today is a result tomorrow.
Racing and boxing
Racing declares by card: /v1/horses/cards/upcoming and /v1/greyhounds/cards/today. Boxing lists /v1/boxing/fights/upcoming with prices.
Plans
Fixtures come with the sport plan, because they are about what is coming. The free key reads yesterday.
Try it
Football: Fixtures, with your key.
200 OK1896 ms2 rows shownReal answer from 2026-11-03, trimmed
{
"data": [
{
"match_id": "fb_p04h38sesj",
"league_id": "fb_3ecv7ykzb0",
"country_name": "Japan",
"league_name": "J2 League",
"season_start_year": 2026,
"kickoff_utc": "2026-11-03T04:55:00Z",
"kickoff_date": "2026-11-03",
"kickoff_local_date": "2026-11-03",
"kickoff_local_time": "04:55",
"match_status": "scheduled",
"home_team_id": "fb_3y29vg3tte",
"home_team_name": "Kataller Toyama",
"away_team_id": "fb_nb55pjkdzs",
"away_team_name": "Vegalta Sendai",
"home_goals": null,
"away_goals": null,
"full_time_result": null,
"half_time_home_goals": null,
"half_time_away_goals": null,
"half_time_result": null,
"stoppage_minutes": null,
"is_kickoff_rescheduled": false,
"elapsed_minutes": null,
"home_league_position": 3,
"away_league_position": 2,
"away_travel_km": 370,
"venue_name": "Toyama Stadium",
"city_name": "Toyama",
"latitude": 36.695916666667,
"longitude": 137.21369444444,
"location_precision": "city",
"daylight_minutes": 638,
"sun_elevation_deg": 28.9,
"public_holiday": null,
"kickoff_temperature_c": null,
"kickoff_rain_mm": null,
"kickoff_wind_ms": null,
"attendance": null,
"referee_name": null,
"kickoff_book_pct": 1.012,
"regular_time_home_goals": null,
"regular_time_away_goals": null,
"regular_time_result": null,
"extra_time_home_goals": null,
"extra_time_away_goals": null,
"shootout_home_goals": null,
"shootout_away_goals": null,
"statistics_status": null,
"best_odds": {
"home": 2.98,
"draw": 3.85,
"away": 2.4,
"book_pct": 1.012,
"taken_utc": "2026-11-03T04:00:03Z"
},
"team_figures": null,
"statistics_reason": null
},
{
"match_id": "fb_4rheazj517",
"league_id": "fb_99zhnmev8a",
"country_name": "Japan",
"league_name": "J3 League",
"season_start_year": 2026,
"kickoff_utc": "2026-11-03T05:00:00Z",
"kickoff_date": "2026-11-03",
"kickoff_local_date": "2026-11-03",
"kickoff_local_time": "05:00",
"match_status": "scheduled",
"home_team_id": "fb_23nh4gt1gq",
"home_team_name": "Gainare Tottori",
"away_team_id": "fb_mk5wdntwz7",
"away_team_name": "Sagamihara",
"home_goals": null,
"away_goals": null,
"full_time_result": null,
"half_time_home_goals": null,
"half_time_away_goals": null,
"half_time_result": null,
"stoppage_minutes": null,
"is_kickoff_rescheduled": false,
"elapsed_minutes": null,
"home_league_position": 15,
"away_league_position": 6,
"away_travel_km": 467,
"venue_name": "Axis Bird Stadium",
"city_name": "Tottori",
"latitude": 35.494388888889,
"longitude": 134.22161111111,
"location_precision": "city",
"daylight_minutes": 642,
"sun_elevation_deg": 30.7,
"public_holiday": null,
"kickoff_temperature_c": null,
"kickoff_rain_mm": null,
"kickoff_wind_ms": null,
"attendance": null,
"referee_name": null,
"kickoff_book_pct": 1.0165,
"regular_time_home_goals": null,
"regular_time_away_goals": null,
"regular_time_result": null,
"extra_time_home_goals": null,
"extra_time_away_goals": null,
"shootout_home_goals": null,
"shootout_away_goals": null,
"statistics_status": null,
"best_odds": {
"home": 3.55,
"draw": 3.8,
"away": 2.12,
"book_pct": 1.0165,
"taken_utc": "2026-11-03T04:00:03Z"
},
"team_figures": null,
"statistics_reason": null
}
],
"meta": {
"sport": "football",
"endpoint": "/fixtures",
"count": 100,
"page": 1,
"per_page": 100,
"total": 3555,
"total_pages": 36,
"next_cursor": "MTc5MzcyODgwMDoxNDk0MzI3",
"next_page": 2,
"prev_page": null,
"as_of": "2026-11-02T05:16:53Z",
"cached": false,
"age_seconds": 0
}
}No key yet? Get a free key: it reads yesterday for every sport and is filled in here once made.
The endpoints
Every sport that answers it.
GET /v1/football/fixturesFootball: Upcoming matches by dateOpen page ›GET /v1/cricket/fixturesCricket: Matches by date, starting todayOpen page ›GET /v1/basketball/fixturesBasketball: Upcoming games by dateOpen page ›GET /v1/rugby/fixturesRugby: Upcoming matches by dateOpen page ›GET /v1/darts/fixturesDarts: Upcoming matches by dateOpen page ›GET /v1/volleyball/fixturesVolleyball: Upcoming matches by dateOpen page ›GET /v1/table-tennis/fixturesTable tennis: Upcoming matches by dateOpen page ›GET /v1/badminton/fixturesBadminton: Upcoming matches by dateOpen page ›GET /v1/football/competitionsFootball: Every competition held, with its seasonsOpen page ›GET /v1/cricket/competitionsCricket: Every competition held, over twelve hundredOpen page ›GET /v1/basketball/competitionsBasketball: Every competition held, with its seasonsOpen page ›GET /v1/rugby/competitionsRugby: Every competition held, with its seasonsOpen page ›GET /v1/volleyball/competitionsVolleyball: Every competition held, with its seasonsOpen page ›