Skip to main content

Standings​

This endpoint allows you to retrieve the standings. For the type argument you can search by: home, away and total.

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 after every finished match.
Recommended Calls: Limit calls to 1 per finished match.

Use Cases​

Get standings
https://american-football.sportdevs.com/standings

Get standing based on the id
https://american-football.sportdevs.com/standings?id=eq.{id}

Get standing from a specific league_id
https://american-football.sportdevs.com/standings?league_id=eq.{league_id}

Get standing from a specific league_id and season_id
https://american-football.sportdevs.com/standings?league_id=eq.{league_id}&season_id=eq.{season_id}

Get standing from a specific league_id, season_id and type
https://american-football.sportdevs.com/standings?league_id=eq.{league_id}&season_id=eq.{season_id}&type=eq.{type}

Query Parameters
  • id integer

    Default value: eq.78500

    The id of the standing

  • type text

    Default value: eq.total

    The type of the standing

  • season_id integer

    Default value: eq.13070

    The id of the season

  • league_id integer

    Default value: eq.2856

    The id of the league

  • 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 standing

    Note: This is a Primary Key.

  • tournament_id integer

    The id of the tournament

    Note: This is a Foreign Key to seasons-by-tournament.tournament_id.

  • tournament_name text

    The name of the tournament

  • type text

    The type of the standing

  • name text

    The name of the standing

  • season_id integer

    The id of the season

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

  • season_name text

    The name of the season

  • league_id integer

    The id of the league

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

  • league_name text

    The name of the league

  • league_hash_image text

    The name image of the league

  • competitors jsonb

    The competitors of the standing

Loading...