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

Group: Tracking data

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.

Plans: Requires the Enterprise plan; every other plan receives 403 endpoint_not_in_plan.

Note: 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

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | fixture id issued by DataSportsAPI, a positive integer |

## Response

- `data`: `TimelineEvent[]`
- `meta`: count
- Objects: TimelineEvent (https://datasportsapi.com/markdown/reference.md#timelineevent)

## Errors

- 403 endpoint_not_in_plan — returned on every plan except Enterprise
- 404 not_found — DataSportsAPI never issued this id

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/tracking/timeline"
```

TypeScript:

```ts
const { data, meta } = await client.tracking.timeline(id);
```

Python:

```python
res = client.tracking.timeline(id)
```

Go:

```go
res, err := client.Tracking.Timeline(ctx, id)
```

CLI:

```bash
$ dsa tracking timeline <id>
```

## Example response

```json
{ "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 } }
```

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/tracking/timeline/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
