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 standingshttps://tennis.sportdevs.com/standings
Get standing based on the idhttps://tennis.sportdevs.com/standings?id=eq.{id}
Get standing from a specific league_idhttps://tennis.sportdevs.com/standings?league_id=eq.{league_id}
Get standing from a specific league_id and season_idhttps://tennis.sportdevs.com/standings?league_id=eq.{league_id}&season_id=eq.{season_id}
Get standing from a specific league_id, season_id and typehttps://tennis.sportdevs.com/standings?league_id=eq.{league_id}&season_id=eq.{season_id}&type=eq.{type}
Query Parameters
- id integer
Default value:
eq.300
The id of the standing
- type text
Default value:
eq.total
The type of the standing
- season_id integer
Default value:
eq.14217
The id of the season
- league_id integer
Default value:
eq.1960
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
- 200
OK
- application/json
- Schema
- Example (from schema)
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
[
{
"id": 300,
"tournament_id": 2303,
"type": "total",
"name": "Doubles, Group Bob Bryan",
"season_id": 14217,
"season_name": "2020 ATP World Tour Finals Men Double",
"league_id": 1960,
"league_name": "ATP Finals, Doubles",
"league_hash_image": "935e3774396904cb3acf14c39908619d5a6d249fb91a9d030c5217baffac50ca",
"competitors": [
{
"wins": 0,
"losses": 3,
"matches": 3,
"team_id": 7397,
"position": 4,
"team_name": "Peers J / Venus M",
"scores_for": 2,
"scores_against": 6,
"team_hash_image": "4bc57f73281582e1b2ff5bb4d6759dba2c621628a63826081f1a96063f4ef34f",
"secondary_scores_for": 51,
"secondary_scores_against": 57
},
{
"wins": 1,
"losses": 1,
"matches": 2,
"team_id": 7347,
"position": 3,
"team_name": "Melzer J / Roger-Vasselin E",
"scores_for": 3,
"scores_against": 3,
"team_hash_image": "67cd3fe014b2dbb2be5c36334c0842e1eeb8d21777d61b016ed22980de02a7d4",
"secondary_scores_for": 33,
"secondary_scores_against": 44
},
{
"wins": 2,
"losses": 0,
"matches": 2,
"team_id": 2723,
"position": 1,
"team_name": "Granollers M / Zeballos H",
"scores_for": 4,
"scores_against": 1,
"team_hash_image": "4cac4e909d02403b7e5b7d3734f8ad05987ba134507bb40771195a985c9c720f",
"secondary_scores_for": 37,
"secondary_scores_against": 32
},
{
"wins": 2,
"losses": 1,
"matches": 3,
"team_id": 7285,
"position": 2,
"team_name": "Pavic M / Soares B",
"scores_for": 5,
"scores_against": 4,
"team_hash_image": "7ba05a871700f743f483dd041bbe1957baa9f25eec6bc2f5f15f3887bbd04089",
"secondary_scores_for": 65,
"secondary_scores_against": 53
}
]
}
]