Get running StarCraft 2 tournaments

200

A list of StarCraft 2 tournaments

Response body

array of objects

Starcraft2ShortTournaments

object

begin_at

date-time | null

required

country

string | null

required

Country code matching the location of the tournament according to the ISO 3166-1 standard (Alpha-2 code). In addition to the standard, the XK code is used for Kosovo. null if unknown

detailed_stats

boolean

required

Whether the tournament is expected to have detailed statistics available

end_at

date-time | null

required

expected_roster

array of objects

required

TournamentRosterItems*

object

players

array of objects

required

BasePlayers*

object

active

boolean

required

Whether player is active

age

number | null

required

≥ 0

Age of the player, null if unknown. When birthday is null, age is an approxiamation. Read more about players' age
Note: This field is only present for users running the Historical plan or above.

birthday

string | null

required

Birth day of the player, YYYY-MM-DD format. null if unknown.
Note: This field is only present for users running the Historical plan or above.

first_name

string | null

required

First name of the player. null if unknown

integer

required

≥ 1

ID of the player

image_url

uri | null

required

URL to the photo of the player. null if not available.

last_name

string | null

required

Last name of the player. null if unknown

modified_at

date-time

required

length ≥ 1

name

string

required

Professional name of the player

nationality

string | null

required

Country code matching the nationality of the player according to the ISO 3166-1 standard (Alpha-2 code).
In addition to the standard, the XK code is used for Kosovo.
null if unknown

role

string | null

required

Role/position of the player. Field value varies depending on the video game.null if unknown.
Note: role is only available for DotA 2, League of Legends, and Overwatch players.
null for other video games.

slug

string | null

required

Unique, human-readable identifier for the player.
id and slug can be used interchangeably throughout the API.

team

object

required

has_bracket

boolean

required

Whether the tournament has a bracket

integer

required

≥ 1

league

object

required

league_id

integer

required

≥ 1

live_supported

boolean

required

Whether live is supported

matches

array of objects

required

BaseMatches*

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

integer

required

≥ 1

live

object

required

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

original_scheduled_at

date-time | null

required

rescheduled

boolean | null

required

Whether match has been rescheduled

scheduled_at

date-time | null

required

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_id

integer

required

≥ 1

winner_id

required

winner_type

string

required

Player Team

modified_at

date-time

required

length ≥ 1

name

string

required

prizepool

string | null

required

region

string | null

required

Region acronym for the location of the tournament.

ASIA EEU ME NA OCE SA WEU

serie

object

required

serie_id

integer

required

≥ 1

slug

string

required

length ≥ 1

teams

array of objects

required

BaseTeams*

object

acronym

string | null

required

integer

required

≥ 1

The ID of the team.

image_url

uri | null

required

URL of the team logo

location

string | null

required

The team's organization location

modified_at

date-time

required

length ≥ 1

name

string

required

The name of the team.

slug

string | null

required

tier

string | null

required

The tier of the tournament, ranging from 'S' to 'Unranked'. Ranking 'S' > 'A' > 'B' > 'C' > 'D' > 'Unranked'

a b c d s unranked

type

string | null

required

Location type for a tournament

offline online online/offline

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

winner_id

required

winner_type

string | null

required

Player Team

200A list of StarCraft 2 tournaments

400Bad request

401Unauthorized

403Forbidden

404Not found

422Unprocessable Entity