# Get league

Endpoint: GET /league
Version: 2.0.7
Security: bearerAuth

## Query parameters:

  - `id` (integer, required)
    The unique identifier of the league
    Example: 618

## Response 200 fields (application/json):

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

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

  - `errors` (object,null)

  - `response` (object,null)
    Represents a football league with relevant information.

  - `response.id` (integer)
    Unique identifier of the league.
    Example: 1

  - `response.name` (string)
    Name of the league.
    Example: "Premier League"

  - `response.type` (string)
    Type of the competition (e.g., league, cup).
    Example: "league"

  - `response.current_season` (string)
    Year of the current season.
    Example: "2025"

  - `response.current_round` (string)
    Current round or stage of the competition.
    Example: "Round 1"

  - `response.country` (object)
    Country object with details

  - `response.country.id` (integer)
    The unique identifier for the country
    Example: 1

  - `response.country.name` (string)
    The name of the country
    Example: "Italy"

  - `response.country.code` (string,null)
    The country ISO 3166-1 alpha-2 code, for regions the format will be custom
    Example: "IT"

  - `response.country.type` (string)
    Type of location, possible values (country, region)
    Example: "country"

  - `response.country.continent` (string,null)
    Continent name
    Example: "Europe"

  - `response.country.flag` (string,null)
    The URL to the country's flag image
    Example: "https://api.goalise.com/logos/countries/IT.svg"

  - `response.country.available_leagues` (integer)
    Number of available leagues from country
    Example: "4"

  - `response.coverage` (object)
    Indicates which data features are covered for a given league.

  - `response.coverage.standings` (boolean)
    Indicates if league standings are available.
    Example: true

  - `response.coverage.fixture_events` (boolean)
    Indicates if fixture events (goals, cards, substitutions) are covered.
    Example: true

  - `response.coverage.fixture_lineup` (boolean)
    Indicates if fixture starting lineups and formations are provided.
    Example: true

  - `response.coverage.fixture_statistics` (boolean)
    Indicates if team statistics for each fixture are available.
    Example: true

  - `response.coverage.fixture_player_statistics` (boolean)
    Indicates if detailed player statistics for fixtures are available.
    Example: true

  - `response.coverage.players` (boolean)
    Indicates if player profiles and data are included.
    Example: true

  - `response.coverage.top_scorers` (boolean)
    Indicates if top goal scorers are tracked for the league.
    Example: true

  - `response.coverage.top_assists` (boolean)
    Indicates if top assist providers are tracked for the league.
    Example: true

  - `response.coverage.top_cards` (boolean)
    Indicates if players with the most cards (yellow/red) are tracked.
    Example: true

  - `response.coverage.news` (boolean)
    Indicates if league-related news is provided.

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