Fixtures by date
/
View as MarkdownTry in Playground →
Fixtures starting on one UTC date, for a single league, one category (country, region or tour, all its leagues at once), one country in a sport, or a whole sport paged ten leagues at a time by league rank.
Parameters
datequeryrequired
UTC date as YYYY-MM-DD, from 1990-01-01 to one year in the future
sportquery
sport slug; mandatory when neither league nor category is set
leaguequery
league id — returns only that league’s fixtures for the date, on a single page (page has to be 0)
categoryquery
category id, as listed by /v2/categories or /v2/fixtures/counts — all leagues of that country, region or tour for the date, sorted by start time, on a single page (page has to be 0). Available since 2026-11-04
countryquery
two-letter Country.code (EN, ES, US …; case-insensitive), used together with sport — returns the date’s fixtures from that country’s categories in the sport, on a single page. Available since 2026-11-04
pagequery
only when sport is the sole filter: page index 0–99 (defaults to 0), each page covering 10 leagues
Response
- data
Fixture[]- meta
- date, page, count, hasNextPage; the league filter adds league (and sport when passed), with page fixed at 0 and hasNextPage false; the category filter adds category (and sport when passed), single page; the country filter adds sport, country, categoryIds (the categories that were queried), complete; sport on its own adds sport, leagueCount (number of leagues on this page), complete (false if some league lists were temporarily unavailable — try again shortly)
- errors
- 400
bad_request— date absent or malformed, sport not recognised, no sport / league / category supplied, country sent without sport, two or more of league / category / country combined, page outside 0–99, or a non-zero page alongside league, category or country404not_found— no category with that id exists in DataSportsAPI503upstream_unavailable— not a single league list on the page could be retrieved
Any /v2 call can also come back with one of the common errors.
$ curl -H "Authorization: Bearer sk_live_…" "https://api.datasportsapi.com/v2/fixtures?date=2026-10-18&sport=football"
{ "data": [ { "id": 201324, "sport": "football", "status": { "type": "finished", … },
"startTime": "2026-10-18T15:30:00.000Z", "league": { "id": 195828, "name": "Premier League", … }, … }, … ],
"meta": { "date": "2026-10-18", "sport": "football", "page": 0, "count": 38, "leagueCount": 10,
"hasNextPage": true, "complete": true } }