Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Tracking data

Match timeline

GET

/v2/fixtures/{id}/tracking/timeline

Enterprise

View as MarkdownTry in Playground →

The timeline of a basketball, ice hockey or darts match, oldest first, filled live about 5 seconds behind play since 2026-11-13 (Enterprise only): every shot and where it was taken (made or missed; on target, blocked or saved), goals with the scorer and assists, penalties and their length, faceoffs, hits, timeouts and the score of each period — and in darts each dart with the bed it landed in and each visit with its score, the points left to get, and the legs and sets.

Events the source withdrew and clock housekeeping are left out. In basketball a made basket has type goal, with points set. Basketball and ice hockey positions run 0–100; home plays towards x = 100 and away towards x = 0 throughout. The source does not say which way a team attacks (its ice hockey spots swap ends every period, and some basketball games swap baskets at half-time), so each side’s positions are mirrored for a period (x → 100 − x, y → 100 − y) whenever its shots in that period fall in the wrong half; a side without shots in a period takes its direction from the opponent and from the neighbouring periods — so while a match is live, an event from a period with no shots yet can still move once shots arrive (sent as an upsert frame). Darts: a dartThrow carries darts.score, number, multiplier, ring (single, double, treble, outerBull, bull or miss), bed (for a single, the inner or outer single bed as the source gives it, since 2026-11-13; null for every other ring) and doubleAttempt; a visit carries darts.score as the visit total, dartsThrown, remaining (what each side still needs), legs and sets; checkout is the visit that took a leg, with checkoutDouble; legWon has the legs in homeScore / awayScore, and setWon and matchWon close the set and the match. Darts events have no position, and some darts competitions are reported visit by visit only. While a match is in play the source can correct an event or take it back, so read the timeline again or follow tracking:{id}. Football and tennis have no timeline, so the list is empty for them.

Parameters

id

pathrequired

fixture id issued by DataSportsAPI, a positive integer

Response

meta
count
errors
403 endpoint_not_in_plan — returned on every plan except Enterprise404 not_found — DataSportsAPI never issued 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/fixtures/{id}/tracking/timeline"
Example
{ "data": [
    { "key": "9be1d07c3a55f26e", "type": "goal", "name": "Goal", "at": "2026-11-11T19:33:12.000Z", "side": "home", "minute": 6, "second": 305,
      "period": null, "position": { "x": 12, "y": 47, "z": null }, "player": "Gerry Fitzgerald", "assists": [ "Al Smith" ], "points": null,
      "penaltyMinutes": null, "homeScore": 1, "awayScore": 0, "darts": null },
    { "key": "c41e9a07b2d85f13", "type": "dartThrow", "name": "Dart throw", "at": "2026-11-13T00:09:17.000Z", "side": "home", "minute": null, "second": null,
      "period": null, "position": null, "player": null, "assists": [], "points": null, "penaltyMinutes": null, "homeScore": null, "awayScore": null,
      "darts": { "score": 60, "number": 20, "multiplier": 3, "ring": "treble", "bed": null, "doubleAttempt": false, "dartsThrown": null, "checkoutDouble": null,
        "remaining": null, "legs": null, "sets": null } }, … ],
  "meta": { "count": 412 } }