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://beach-volleyball.sportdevs.com/standings

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

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

Get standing from a specific league_id and season_id
https://beach-volleyball.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://beach-volleyball.sportdevs.com/standings?league_id=eq.{league_id}&season_id=eq.{season_id}&type=eq.{type}

Query Parameters
  • id integer

    Default value: eq.85244

    The id of the standing

  • type text

    Default value: eq.total

    The type of the standing

  • season_id integer

    Default value: eq.13888

    The id of the season

  • league_id integer

    Default value: eq.3530

    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.

  • 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

GET /standings

Request

Base URL
https://beach-volleyball.sportdevs.com
id — query
type — query
season_id — query
league_id — query
offset — query
limit — query
lang — query
curl -L -X GET 'https://beach-volleyball.sportdevs.com/standings' \
-H 'Accept: application/json'