> ## Documentation Index
> Fetch the complete documentation index at: https://www.thestatsapi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /football/players/{player_id}/stats

> Retrieve a player's competition-season statistics, with optional stage filtering.

Get player statistics

## Endpoint

```text theme={null}
GET https://api.thestatsapi.com/api/football/players/{player_id}/stats
```

Retrieve statistics for a player in a specific season.

## Path parameters

| Name        | Type   | Required | Description                                              |
| ----------- | ------ | -------- | -------------------------------------------------------- |
| `player_id` | string | Yes      | Unique identifier for the player. Example: `pl_29627593` |

## Query parameters

| Name             | Type                                       | Required | Default | Description                                                                                                                                              |
| ---------------- | ------------------------------------------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `season_id`      | string                                     | Yes      |         | Season identifier. Example: `sn_6125938`                                                                                                                 |
| `competition_id` | string                                     | No       |         | Filter statistics by competition. Example: `comp_3039`                                                                                                   |
| `stage`          | string — enum: `regular`, `playoff`, `all` | No       | `all`   | Restrict statistics to regular/group-stage fixtures, playoff/knockout fixtures, or all fixtures. Values: `regular`, `playoff`, `all`. Example: `regular` |

## Response (200)

```json theme={null}
{
  "data": {
    "player_id": "pl_29627593",
    "season_id": "sn_6125938",
    "team_id": "tm_0406",
    "position": "M",
    "rating": 7.24,
    "appearances": 37,
    "starts": 35,
    "minutes_played": 3120,
    "scoring": {
      "goals": 18,
      "assists": 7,
      "goals_assists_sum": 25,
      "goal_conversion_percentage": 18.4,
      "penalties_taken": 4,
      "penalty_goals": 3,
      "big_chances_created": 10,
      "big_chances_missed": 8
    },
    "shooting": {
      "total_shots": 98,
      "shots_on_target": 52,
      "shots_off_target": 46
    },
    "passing": {
      "total_passes": 1420,
      "accurate_passes": 1210,
      "inaccurate_passes": 210,
      "pass_accuracy": 85.2,
      "key_passes": 72,
      "accurate_crosses": 35,
      "accurate_crosses_percentage": 31.5,
      "accurate_own_half_passes": 420,
      "accurate_opposition_half_passes": 790,
      "accurate_final_third_passes": 310
    },
    "defending": {
      "tackles": 28,
      "interceptions": 14
    },
    "duels": {
      "ground_duels_won": 120,
      "ground_duels_won_percentage": 54.2,
      "aerial_duels_won": 30,
      "aerial_duels_won_percentage": 48.4,
      "total_duels_won": 150,
      "total_duels_won_percentage": 53.1,
      "successful_dribbles": 44,
      "successful_dribbles_percentage": 61.1
    },
    "discipline": {
      "yellow_cards": 3,
      "red_cards": 0,
      "direct_red_cards": 0,
      "penalty_won": 2,
      "penalty_conceded": 0
    }
  }
}
```

<Note>
  This page is generated from the live API contract at `https://api.thestatsapi.com/llms.txt`.
</Note>