List matches

200

A list of matches of any e-sport

Response body

array of objects

Matches

object

begin_at

date-time | null

required

detailed_stats

boolean

required

Whether the match offers full stats

draw

boolean

required

Whether result of the match is a draw

end_at

date-time | null

required

forfeit

boolean

required

Whether match was forfeited

game_advantage

integer | null

required

≥ 1

ID of the opponent with a game advantage

games

array of objects

required

Games*

object

begin_at

date-time | null

required

The game begin time, UTC.
null when the game status is not_started

complete

boolean

required

Whether When true, the game statistics are complete and will not be updated again

detailed_stats

boolean

required

Whether historical data is available for the game

end_at

date-time | null

required

The game end time, UTC.
null when the game status is not finished

finished

boolean

required

Whether the game is finished

forfeit

boolean

required

Whether the game has been forfeited

required

ID of the game.
IDs are video game-specific, ie. a Valorant game and an Overwatch game can have the same game ID.

length

integer | null

required

≥ 0

Duration of the game in seconds.
null when the game status is not finished

match_id

integer

required

≥ 1

position

integer

required

≥ 1

Game position in the match. Starts at 1

status

string

required

The game status

finished not_played not_started running

winner

object

required

winner_type

string | null

required

Player Team

integer

required

≥ 1

league

object

required

league_id

integer

required

≥ 1

live

object

required

map_picks

array of objects | null

Only applies to Valorant matches. The field will not be present on other video games matches.
Map picks, null when map picks data is unavailable.
Important: map_picks field is only present in the response for subscribers of Valorant Historical plan.

ValorantMapPicks

object

integer

required

≥ 1

ID of the map

image_url

uri

required

URL to an image of the map

name

string

required

Name of the map

picking_team_id

integer | null

required

≥ 1

ID of the team that picked the map

slug

string

required

length ≥ 1

Human-readable identifier of the map

videogame_versions

array of strings

required

Array of of video game versions (ie. patches) for this resource

VideogameVersions*

match_type

string

required

all_games_played best_of custom first_to ow_best_of red_bull_home_ground

modified_at

date-time

required

length ≥ 1

name

string

required

number_of_games

integer

required

≥ 0

Number of games

opponents

array of objects

required

Opponents*

object

opponent

required

type

string

required

Player Team

original_scheduled_at

date-time | null

required

rescheduled

boolean | null

required

Whether match has been rescheduled

results

array

required

MatchResults*

scheduled_at

date-time | null

required

serie

object

required

serie_id

integer

required

≥ 1

slug

string | null

required

status

string

required

canceled finished not_started postponed running

streams_list

array of objects

required

StreamsList*

object

embed_url

uri | null

required

URL to embed in an iframe.

language

string

required

Language alpha-2 code according to ISO 649-1 standard.

aa ab ae af ak am an ar as av ay az ba be bg bh bi bm bn bo br bs ca ce ch co cr cs cu cv cy da de dv dz ee el en eo es et eu fa ff fi fj fo fr fy ga gd gl gn gu gv ha he hi ho hr ht hu hy hz ia id ie ig ii ik io is it iu ja jv ka kg ki kj kk kl km kn ko kr ks ku kv kw ky la lb lg li ln lo lt lu lv mg mh mi mk ml mn mr ms mt my na nb nd ne ng nl nn no nr nv ny oc oj om or os pa pi pl ps pt qu rm rn ro ru rw sa sc sd se sg si sk sl sm sn so sq sr ss st su sv sw ta te tg th ti tk tl tn to tr ts tt tw ty ug uk ur uz ve vi vo wa wo xh yi yo za zh zu

main

boolean

required

Whether it is the main stream. Main stream is always official.

official

boolean

required

Whether it is an official broadcast.

raw_url

uri

required

URL to the stream on host website.

tournament

object

required

tournament_id

integer

required

≥ 1

videogame

object

required

[object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object] [object Object]

Has additional fields

videogame_title

object | null

required

videogame_version

object | null

required

winner

required

winner_id

required

winner_type

string

required

Player Team

200A list of matches of any e-sport

400Bad request

401Unauthorized

403Forbidden

404Not found

422Unprocessable Entity