Skip to main content

Leagues​

This endpoint allows you to retrieve the leagues and the cups.

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated several times a day.
Recommended Calls: Limit calls to 1 every day.

You can get the image of the league by calling the following url: https://images.sportdevs.com/{hash_image}.png

Use Cases​

Get leagues
https://football.sportdevs.com/leagues

Search the leagues by the name
https://football.sportdevs.com/leagues?name=like.*Championship*

Get leagues based on the id
https://football.sportdevs.com/leagues?id=eq.{id}

Get leagues from a specific class_id
https://football.sportdevs.com/leagues?class_id=eq.{class_id}

Query Parameters
  • id integer

    Default value: eq.1

    The id of the league

  • class_id integer

    Default value: eq.130

    The id of the class

  • offset string

    Default value: 0

    Limiting and Pagination

  • limit string

    Default value: 50

    Limiting and Pagination

  • lang string

    Default value: en

    Multi-language

Responses

OK

Schema array
  • id integer

    The id of the league

    Note: This is a Primary Key.

  • name text

    The name of the league

  • importance integer

    The importance level of the league

  • level integer

    The level of the league

  • current_champion_team_id integer

    The id of the team that hold the title

  • current_champion_team_name text

    The name of the team that hold the title

  • current_champion_team_hash_image character varying

    Possible values: <= 64 characters

    The name image of the team that hold the title

  • current_champion_team_num_titles integer

    The number of the title that the team is holding

  • teams_most_titles jsonb

    The ids of the teams with the most titles

  • most_titles integer

    The number of the most titles accomplished by one team

  • primary_color character varying

    Possible values: <= 7 characters

    The primary color of the league

  • secondary_color character varying

    Possible values: <= 7 characters

    The secondary color of the league

  • connected_leagues jsonb

    The ids of connected leagues

  • higher_leagues jsonb

    The ids of higher leagues

  • lower_leagues jsonb

    The ids of lower leagues

  • start_league timestamp with time zone

    The date of starting the league

  • end_league timestamp with time zone

    The date of ending the league

  • hash_image character varying

    Possible values: <= 64 characters

    The name of the image

  • class_id integer

    The id of the class

    Note: This is a Foreign Key to classes.id.

  • class_name text

    The name of the class

  • class_hash_image character varying

    Possible values: <= 64 characters

    The name image of the class

Loading...