Skip to content
datasportsAPI

LeaguesFeatured fixtures

Documentation

/

Type to filter the docs by title or path.

LeaguesEndpoint 83 of 116

Featured fixtures

GET

/v2/leagues/{id}/featured-fixtures

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

Matches our data source highlights for a league, typically the standout game of the round.

Worth knowing

Normally a single match, or an empty array if nothing is highlighted. During play, the live state is accurate to the second.

01Parameters

  • idpathRequired

    league id issued by DataSportsAPI, a positive integer

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/leagues/{id}/featured-fixtures"

03Response

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

data
Fixture[]
meta
count
ObjectsFixture
Example response
{ "data": [ { "id": 701300, "status": { "type": "notstarted", … }, "startTime": "2026-11-07T12:00:00.000Z",
      "home": { "name": "Everton", … }, "away": { "name": "Coventry City", … }, … } ],
  "meta": { "count": 1 } }

04Errors

Nothing specific to this endpoint: only the account-wide errors below apply.

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code