# Get player league statistics

Returns a paginated list of player statistics in a league for a given season and team

Endpoint: GET /player-statistics
Version: 2.0.7
Security: bearerAuth

## Query parameters:

  - `league_id` (integer, required)
    ID of the league
    Example: 621

  - `player_id` (integer)
    Filter by ID of the player

  - `team_id` (integer, required)
    ID of the team
    Example: 69

  - `season` (integer, required)
    Season year
    Example: 2024

## Response 200 fields (application/json):

  - `status` (string)
    Example: "success"

  - `pagination` (object,null)
    Pagination info if applicable

  - `errors` (object,null)

  - `response` (array,null)

  - `response.player_id` (integer)
    Unique identifier of the player
    Example: 123

  - `response.team_id` (integer)
    Unique identifier of the team the player belongs to
    Example: 45

  - `response.league_id` (integer)
    Unique identifier of the league
    Example: 10

  - `response.season` (integer)
    The season in which the statistics were recorded
    Example: 2025

  - `response.statistics` (object)
    Detailed player league performance statistics.

  - `response.statistics.cards` (object)
    Card statistics

  - `response.statistics.cards.red` (integer)
    Number of red cards

  - `response.statistics.cards.yellow` (integer)
    Number of yellow cards
    Example: 1

  - `response.statistics.cards.yellowred` (integer)
    Number of second yellow cards resulting in red

  - `response.statistics.duels` (object)
    Duels statistics

  - `response.statistics.duels.won` (integer)
    Number of duels won
    Example: 9

  - `response.statistics.duels.total` (integer)
    Total number of duels
    Example: 18

  - `response.statistics.fouls` (object)
    Fouls statistics

  - `response.statistics.fouls.drawn` (integer)
    Number of fouls drawn
    Example: 1

  - `response.statistics.fouls.committed` (integer)
    Number of fouls committed
    Example: 2

  - `response.statistics.games` (object)
    Game appearance and participation data

  - `response.statistics.games.number` (integer,null)
    Game number

  - `response.statistics.games.rating` (string)
    Average match rating
    Example: "6.833333"

  - `response.statistics.games.captain` (boolean)
    Whether the player was captain

  - `response.statistics.games.lineups` (integer)
    Number of times included in starting lineup
    Example: 3

  - `response.statistics.games.minutes` (integer)
    Total minutes played
    Example: 216

  - `response.statistics.games.position` (string)
    Playing position
    Example: "Midfielder"

  - `response.statistics.games.appearences` (integer)
    Number of appearances
    Example: 3

  - `response.statistics.goals` (object)
    Goal-related statistics

  - `response.statistics.goals.saves` (integer,null)
    Number of saves (for goalkeepers)

  - `response.statistics.goals.total` (integer)
    Total goals scored

  - `response.statistics.goals.assists` (integer,null)
    Number of assists

  - `response.statistics.goals.conceded` (integer)
    Goals conceded (for goalkeepers)

  - `response.statistics.shots` (object)
    Shooting statistics

  - `response.statistics.shots.on` (integer)
    Shots on target
    Example: 1

  - `response.statistics.shots.total` (integer)
    Total shots
    Example: 1

  - `response.statistics.passes` (object)
    Passing statistics

  - `response.statistics.passes.key` (integer,null)
    Number of key passes

  - `response.statistics.passes.total` (integer)
    Total passes attempted
    Example: 150

  - `response.statistics.passes.accuracy` (integer)
    Pass accuracy percentage
    Example: 49

  - `response.statistics.penalty` (object)
    Penalty statistics

  - `response.statistics.penalty.won` (integer,null)
    Penalties won

  - `response.statistics.penalty.saved` (integer,null)
    Penalties saved by player (goalkeeper)

  - `response.statistics.penalty.missed` (integer)
    Penalties missed

  - `response.statistics.penalty.scored` (integer)
    Penalties scored

  - `response.statistics.penalty.commited` (integer,null)
    Penalties conceded

  - `response.statistics.tackles` (object)
    Tackling statistics

  - `response.statistics.tackles.total` (integer)
    Total tackles
    Example: 2

  - `response.statistics.tackles.blocks` (integer)
    Number of blocks
    Example: 2

  - `response.statistics.tackles.interceptions` (integer)
    Number of interceptions
    Example: 2

  - `response.statistics.dribbles` (object)
    Dribbling statistics

  - `response.statistics.dribbles.past` (integer,null)
    Times dribbled past by opponents

  - `response.statistics.dribbles.success` (integer)
    Successful dribbles
    Example: 4

  - `response.statistics.dribbles.attempts` (integer)
    Dribble attempts
    Example: 4

  - `response.statistics.substitutes` (object)
    Substitution details

  - `response.statistics.substitutes.in` (integer)
    Times substituted in

  - `response.statistics.substitutes.out` (integer)
    Times substituted out
    Example: 2

  - `response.statistics.substitutes.bench` (integer)
    Times on the bench

## Response 400 fields (application/json):

  - `status` (string)
    Example: "error"

  - `pagination` (object,null)

  - `errors` (array,null)

  - `errors.type` (string)
    Example: "validation_error"

  - `errors.data` (object)

  - `response` (object,null)

## Response 500 fields (application/json):

  - `status` (string)
    Example: "error"

  - `pagination` (object,null)

  - `errors` (array,null)

  - `errors.type` (string)
    Example: "validation_error"

  - `errors.data` (object)

  - `response` (object,null)