Matches Games
This endpoint allows you to retrieve the games.
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 per day.
Recommended Calls: Limit calls to 1 every 15 minutes.
Use Cases
Get gameshttps://esports.sportdevs.com/matches-games
Get games from a specific match_idhttps://esports.sportdevs.com/matches-games?match_id=eq.{match_id}
Query Parameters
- id integer
Default value:
eq.1
The id of the game
- match_id integer
Default value:
eq.1
The id of the match
- 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 game
Note: This is a Primary Key.
- match_id integer
The id of the match
Note: This is a Foreign Key to
matches-live.id
. - length integer
The length of the game in seconds
- winner integer
The winner of the game [home team - 1, away team - 2]
- status jsonb
The status of the game
- status_type text
The status type of the game
- map text
The name of the map
- home_team_score jsonb
The home team score
- away_team_score jsonb
The away team score
- home_team_starting_side integer
The home team starting side
- start_time timestamp with time zone
The start of the game
- has_rounds boolean
The rounds in the game
- has_lineups boolean
If the game has lineups
- has_statistics boolean
If the game has statistics
- has_bans boolean
If the game has bans
[
{
"id": 1,
"match_id": 1,
"length": 1759,
"winner": 1,
"status": {
"type": "finished",
"reason": "Ended"
},
"status_type": "finished",
"home_team_score": {
"display": 13
},
"away_team_score": {
"display": 6
},
"home_team_starting_side": 1,
"start_time": "2022-10-20T21:07:23+00:00",
"has_rounds": false,
"has_lineups": true,
"has_statistics": true,
"has_bans": true
}
]