Penalties
GET
/
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
idpathrequired
DataSportsAPI player id, a positive integer
leaguequeryrequired
league id, as listed by /v2/players/{id}/seasons
seasonqueryrequired
season id, as listed by /v2/leagues/{id}/seasons
Response
- data
PenaltyHistory- meta
- league, season, count
- errors
- 403
history_not_in_plan— the season finished before your plan’s history window begins403endpoint_not_in_plan— returned to keys on the Free and Starter plans404not_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 } }