# Get top scorers

Returns a list of top scoring players for a given league and season

Endpoint: GET /top-scorers
Version: 2.0.7
Security: bearerAuth

## Query parameters:

  - `league_id` (integer, required)
    League ID
    Example: 621

  - `season` (integer, required)
    Season
    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.league_id` (integer)
    ID of the league
    Example: 45

  - `response.player_id` (integer)
    ID of the player
    Example: 1098

  - `response.rank` (integer)
    Player's rank in the goal scoring leaderboard
    Example: 1

  - `response.season` (integer)
    Season year
    Example: 2024

  - `response.statistics` (array)

  - `response.statistics.games` (object)

  - `response.statistics.games.appearences` (integer)
    Number of games played
    Example: 25

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

  - `response.statistics.goals` (object)

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

  - `response.statistics.goals.assists` (integer)
    Total assists made
    Example: 5

  - `response.statistics.goals.canceled` (integer)
    Goals conceded or canceled
    Example: 1

  - `response.statistics.shots` (object)

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

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

  - `response.statistics.penalty` (object)

  - `response.statistics.penalty.won` (integer)
    Penalties won
    Example: 2

  - `response.statistics.penalty.commited` (integer)
    Penalties committed
    Example: 1

  - `response.statistics.penalty.success` (integer)
    Successful penalty goals
    Example: 1

  - `response.statistics.penalty.missed` (integer)
    Missed penalties
    Example: 1

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

  - `response.statistics.cards` (object)

  - `response.statistics.cards.yellow` (integer)
    Yellow cards received
    Example: 3

  - `response.statistics.cards.red` (integer)
    Red cards received
    Example: 1

  - `response.statistics.cards.second_yellow` (integer)
    Second yellow cards

## 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)