Skip to content
datasportsAPI

TeamsFeatured fixture

Documentation

/

Type to filter the docs by title or path.

TeamsEndpoint 50 of 116

Featured fixture

GET

/v2/teams/{id}/featured-fixture

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

Returns the match the source highlights for a team, which is normally its next fixture or the one it is playing right now.

Worth knowing

While the match is live, score and clock are accurate to the second.

01Parameters

  • idpathRequired

    DataSportsAPI team id, 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/teams/{id}/featured-fixture"

03Response

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

data
Fixture
ObjectsFixture
Example response
{ "data": { "id": 701540, "sport": "football", "status": { "type": "notstarted", … }, "startTime": "2026-11-04T17:45:00.000Z",
    "league": { "id": 195900, "name": "UEFA Champions League", … }, "home": { "id": 3120, "name": "SK Slavia Praha", … },
    "away": { "id": 18, "name": "Arsenal", … }, … },
  "meta": {} }

04Errors

  • 404no_data

    the source is not highlighting any match for this team at the moment; 404 not_found — DataSportsAPI has never assigned this id

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code