Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Fixtures

Shot map

GET

/v2/fixtures/{id}/shotmap

Pro and up

View as MarkdownTry in Playground →

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.

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

id

pathrequired

fixture id issued by DataSportsAPI, a positive integer

Response

data
Shot[]
meta
count

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