Tracking data

Match timeline

GET/v2/fixtures/{id}/tracking/timelineEnterprise

The match timeline of basketball, ice hockey and darts, oldest first — live, about 5 seconds behind play (since 2026-11-13): every shot with its location (made, missed, on target, blocked, saved), goals with scorer and assists, penalties with their minutes, faceoffs, hits, timeouts and period scores; in darts every dart (the bed it hit) and every visit (its score, the points still needed, legs and sets). Enterprise plan only.

Withdrawn events and clock bookkeeping are left out. Basketball: a made basket is type goal with points. Basketball and ice hockey positions are 0–100 with the home side attacking x = 100 and the away side x = 0 all match. The source reports no attack direction (its ice hockey spots change ends every period, some basketball games at half-time), so per side and period we mirror (x → 100 − x, y → 100 − y) a side whose shots lie in the wrong half; a side with no shots in a period follows the other side and the neighbouring periods — live, an event of a period without shots yet can move once they come (an upsert frame). Darts: dartThrow (darts.score, number, multiplier, ring — single, double, treble, outerBull, bull, miss —, bed — a single’s inner or outer single as the source reports it, since 2026-11-13; null otherwise — and doubleAttempt), visit (darts.score = the visit’s total, dartsThrown, remaining = points each side still needs, legs, sets), checkout (the visit that won a leg, with checkoutDouble), legWon (homeScore / awayScore = legs), setWon, matchWon; position is always null. Some darts competitions report visits only. The source may revise an event while the match is live, or withdraw it: read again, or follow tracking:{id}. Empty for football and tennis.

Parameters

pathrequired

our numeric id (positive integer)

Response

data: TimelineEvent[]
meta: count
errors: 403 endpoint_not_in_plan — every plan but Enterprise404 not_found — an id we never issued

Every /v2 call can also answer the common errors.

Try it →

$ curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/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 } }