Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Teams

Featured fixture

GET

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

All plans

View as MarkdownTry in Playground →

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

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

Parameters

id

pathrequired

DataSportsAPI team id, a positive integer

Response

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

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/teams/{id}/featured-fixture"
Example
{ "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": {} }