SofaScore

SofaScore player penalty history

Returns the penalties a player has taken, newest first: the totals (attempts, scored) and, per penalty, the outcome (goal, miss, post or save), the zone of the goal (for example low-right, high-left, close-high), the x and y position in the goal mouth on SofaScore's 0 to 100 scale, the expected-goals value when available and the match. Returns 404 for players with no recorded penalties, such as most goalkeepers and defenders.

get/sofascore/player-penalty-history

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/sofascore/player-penalty-history
  • Auth: API key in header x-api-key

Query parameters

idstring required

Numeric SofaScore player id

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "attempts": 61,
    "penalties": [
      {
        "event": {
          "away_team": {
            "country": "Spain",
            "id": 2817,
            "name": "FC Barcelona",
            "short_name": "Barcelona",
            "slug": "barcelona"
          },
          "home_team": {
            "country": "Spain",
            "id": 2817,
            "name": "FC Barcelona",
            "short_name": "Barcelona",
            "slug": "barcelona"
          },
          "id": 14025013,
          "start_time": "2025-08-15T19:00:00Z",
          "status": {
            "description": "Ended",
            "type": "finished"
          },
          "tournament": {
            "category": "England",
            "name": "Premier League",
            "slug": "premier-league",
            "unique_tournament_id": 17,
            "unique_tournament_name": "Premier League"
          }
        },
        "id": 6089564,
        "outcome": "goal",
        "x": 68.82,
        "xg": 0.78,
        "y": 95.83,
        "zone": "low-right"
      }
    ],
    "player_id": 839956,
    "scored": 52
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.