# GET /v2/fixtures/{id}/shotmap

Group: Fixtures

All shots, oldest first, with outcome and expected goals; football gives expectedGoals / expectedGoalsOnTarget, pitch and goal-mouth coordinates, body part and situation, ice hockey technique and strength. Ice hockey shots also carry rink coordinates; basketball lists each field-goal attempt as made, missed or blocked along with its court location.

Plans: Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.

Note: Available for football, ice hockey and basketball in covered leagues; any other case returns an empty array. In football and ice hockey, outcome is goal | save | miss | block | post, and a football shot cleared off the line counts as a block. In basketball the outcomes are goal (made), miss and block; positions are measured from the basket in tenths of a foot, the player and time fields are null, and every home shot comes before the away shots. Only ice hockey uses technique (wrist, snap, slap, …) and strength. goalType is regular, ownGoal or penalty. Shoot-out kicks appear at the end: shootoutSequence is the order of kicks across both teams (matching the events), and shootoutRound is the kick’s number (1st, 2nd, …) for the taker’s side. In football, period (since 2026-10-24; null for earlier data) is derived from the minute: period1, period2, extra1, extra2, or penalties for a shoot-out kick. While a match is live the list is re-read about every 30 seconds; fixture:{id} WebSocket channels (Business and Enterprise) receive the entire list as a shotmap frame whenever it changes.

## Parameters

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

## Response

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

## Errors

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}/shotmap"
```

TypeScript:

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

Python:

```python
res = client.fixtures.shotmap(id)
```

Go:

```go
res, err := client.Fixtures.Shotmap(ctx, id)
```

CLI:

```bash
$ dsa fixtures shotmap <id>
```

## Example response

```json
{ "data": [ …, { "side": "away", "outcome": "goal", "technique": null, "goalType": "regular",
    "situation": "assisted", "bodyPart": "rightFoot", "strength": null, "expectedGoals": 0.028, "expectedGoalsOnTarget": 0.165,
    "minute": 80, "addedMinute": null, "second": 4770, "period": "period2",
    "player": { "id": 3759, "name": "Bukayo Saka", … }, "goalkeeper": { "id": 4101, "name": "Matz Sels", … },
    "position": { "x": 13.4, "y": 27.5, "z": 0 }, "goalMouth": { "x": 0, "y": 48.4, "z": 24.1 },
    "goalMouthLocation": "highCentre", "blockPosition": null, "shootoutSequence": null, "shootoutRound": null } ],
  "meta": { "count": 23 } }

// Ice hockey:
{ "data": [ { "side": "home", "outcome": "save", "technique": "wrist", "strength": "powerPlay", "expectedGoals": 0.036,
    "minute": 1, "second": 46, "period": "period1", "position": { "x": 50, "y": 22, "z": null }, … }, … ],
  "meta": { "count": 61 } }

// Basketball:
{ "data": [ { "side": "home", "outcome": "goal", "player": null, "minute": null, "second": null,
    "position": { "x": -132, "y": 168, "z": null }, … }, … ],
  "meta": { "count": 171 } }
```

---

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/fixtures/shotmap/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
