Fixtures by date

GET

https://api.datasportsapi.com/v2/fixtures

Plan: All plans
Auth: Bearer dsa_live_…
Parameters: 1 required · 5 optional
Returns: Fixture[]

Lists the fixtures that start on a given UTC date. Scope the call to a single league, a single category (country, region or tour — all of its leagues at once), one country within a sport, or an entire sport, which is paged ten leagues at a time in league-ranking order.

Worth knowing

Need a single country’s schedule, amateur and youth competitions included?
Pass category= (take the id from that day’s /v2/fixtures/counts?sport= or from /v2/categories), or combine sport= with country=; either returns everything in one request rather than paging through the sport.
When only sport is set, keep requesting pages until hasNextPage is false.
All pages except the final one contain 10 leagues, so an empty page tells you the day is exhausted; a page may still carry fewer fixtures than leagues, because a league whose matches sit just outside the UTC day adds nothing.
The set of fixtures for a date is cached — for minutes on today and future dates, for hours on past dates, and permanently once every fixture has finished — whereas the status, score and clock of a live fixture are accurate to the second (details in Data freshness).
If you need a live feed, /v2/livescores or the WebSocket is the better fit.

01Parameters

Name	In	Required	Description
`date`	query	Required	UTC date as YYYY-MM-DD, from 1990-01-01 to one year in the future
`sport`	query	Optional	sport slug; mandatory when neither league nor category is set
`league`	query	Optional	league id — returns only that league’s fixtures for the date, on a single page (page has to be 0)
`category`	query	Optional	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
`country`	query	Optional	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
`page`	query	Optional	only when sport is the sole filter: page index 0–99 (defaults to 0), each page covering 10 leagues

datequeryRequired
UTC date as YYYY-MM-DD, from 1990-01-01 to one year in the future
sportqueryOptional
sport slug; mandatory when neither league nor category is set
leaguequeryOptional
league id — returns only that league’s fixtures for the date, on a single page (page has to be 0)
categoryqueryOptional
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
countryqueryOptional
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
pagequeryOptional
only when sport is the sole filter: page index 0–99 (defaults to 0), each page covering 10 leagues

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/fixtures?date=…"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

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)

ObjectsFixture

Example call and response

6 lines

$ curl -H "Authorization: Bearer dsa_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 } }

04Errors

400bad_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 country
404not_found
no category with that id exists in DataSportsAPI
503upstream_unavailable
not a single league list on the page could be retrieved

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code