Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Players

Penalties

GET

/v2/players/{id}/penalties

Pro and up

View as MarkdownTry in Playground →

Football penalty record for a player across one league season: totals scored and taken, plus each kick: its fixture, its outcome (goal, save, miss, post), its xG and where in the goal it went. Available since 2026-11-04.

Only penalties during play are included, not shoot-outs, ordered oldest first. goalMouth uses the same goal-mouth frame as the shot map. Without source data, the list is empty and the counts are null.

Parameters

id

pathrequired

DataSportsAPI player id, a positive integer

league

queryrequired

league id, as listed by /v2/players/{id}/seasons

season

queryrequired

season id, as listed by /v2/leagues/{id}/seasons

Response

meta
league, season, count
errors
403 history_not_in_plan — the season finished before your plan’s history window begins403 endpoint_not_in_plan — returned to keys on the Free and Starter plans404 not_found — the season id does not belong to this league

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/players/{id}/penalties?league=…&season=…"
Example
{ "data": { "scored": 1, "attempts": 1, "penalties": [ { "fixtureId": 201324, "startTime": "2026-09-12T19:00:00.000Z", "outcome": "goal",
      "goalMouthLocation": "lowRight", "goalMouth": { "x": 74.19, "y": 96.83, "z": null }, "expectedGoals": 0.7884 } ] },
  "meta": { "league": 200001, "season": 200386, "count": 1 } }