# Get league standings

Returns grouped league standings for a given league. If no season is provided, current season will be used.

Endpoint: GET /league-standing
Version: 2.0.7
Security: bearerAuth

## Query parameters:

  - `id` (integer, required)
    League ID
    Example: 618

  - `season` (integer)
    Season year (optional, defaults to current)
    Example: 2024

## Response 200 fields (application/json):

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

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

  - `errors` (object,null)

  - `response` (array,null)
    Array of standing groups, where each group contains multiple standing entries

  - `response.rank` (integer)
    Current position of the team in the standings
    Example: 1

  - `response.league_id` (integer)
    ID of the league
    Example: 12

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

  - `response.group` (string)
    Group name
    Example: "Group A"

  - `response.team_id` (integer)
    ID of the team
    Example: 305

  - `response.form` (string)
    Recent form of the team, represented by W/D/L
    Example: "WDLWW"

  - `response.status` (string)
    Current status in the league (e.g., promoted, relegated)
    Example: "same"

  - `response.description` (string,null)
    Extra description about the team’s standing
    Example: "Champions League"

  - `response.goals_diff` (integer)
    Goal difference (goals for - goals against)
    Example: 25

  - `response.points` (integer)
    Total points earned
    Example: 65

  - `response.all` (object)
    Basic standing statistics for a team in the league

  - `response.all.matches_played` (integer)
    Total number of matches played
    Example: 30

  - `response.all.win` (integer)
    Number of matches won
    Example: 18

  - `response.all.draw` (integer)
    Number of matches drawn
    Example: 6

  - `response.all.lose` (integer)
    Number of matches lost
    Example: 6

  - `response.all.goals_for` (integer)
    Goals scored by the team
    Example: 55

  - `response.all.goals_against` (integer)
    Goals conceded by the team
    Example: 30

  - `response.home` (object)
    Basic standing statistics for a team in the league

  - `response.away` (object)
    Basic standing statistics for a team in the league

  - `response.last_update` (string)
    Last time the data was updated
    Example: "2025-03-29 18:45:00"

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