DotaScore API Docs

Code	Meaning
200	OK
401	Missing or invalid API key
402	Free trial used / monthly quota exceeded — upgrade your plan
429	Rate limit exceeded (per-minute) — back off and retry after the `Retry-After` header
5xx	Server error — please retry with exponential backoff

Matches

Live, upcoming, and past Dota 2 esports matches with PandaScore-style envelopes.

get/dota2/matches

Recent pro matches (reconciled)

Parameters

Name	In	Type	Required
page	query	integer	no
per_page	query	integer	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/matches

get/dota2/matches/{match_id}

Match detail by ID

Parameters

Name	In	Type	Required
match_id	path	integer	yes
format	query	string	no
enrich_liquipedia	query	boolean	no
include	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/matches/{match_id}

get/dota2/matches/{match_id}/live_state

One-shot live-match state composite

Parameters

Name	In	Type	Required
match_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/matches/{match_id}/live_state

get/dota2/matches/{match_id}/widget

UI widget one-shot payload

Parameters

Name	In	Type	Required
match_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/matches/{match_id}/widget

get/dota2/matches/{match_id}/win_probability

Live / pre-match win probability

Parameters

Name	In	Type	Required
match_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/matches/{match_id}/win_probability

get/dota2/matches/feed

Grouped matches feed — live + upcoming by date

Parameters

Name	In	Type	Required
days_back	query	integer	no
days_forward	query	integer	no
include_odds	query	boolean	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/matches/feed

get/dota2/matches/live/stream

Twitch streams for live matches

Parameters

Name	In	Type	Required
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/matches/live/stream

get/dota2/matches/past

Past/finished matches

Parameters

Name	In	Type	Required
page	query	integer	no
per_page	query	integer	no
raw	query	boolean	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/matches/past

get/dota2/matches/running

Currently live matches

Parameters

Name	In	Type	Required
raw	query	boolean	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/matches/running

get/dota2/matches/upcoming

Upcoming scheduled matches

Parameters

Name	In	Type	Required
raw	query	boolean	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/matches/upcoming

Bookmaker Odds

Pinnacle moneyline, spreads, totals, and per-map markets for upcoming matches.

get/dota2/odds

Dota 2 betting odds

Parameters

Name	In	Type	Required
event_type	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/odds

get/dota2/odds/movement

Price movement history for one event

Parameters

Name	In	Type	Required
event_id	query	integer	yes
hours	query	integer	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/odds/movement

get/dota2/odds/raw

Raw Pinnacle odds payload

Parameters

Name	In	Type	Required
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/odds/raw

Teams

Pro teams, their player rosters, and recent match results.

get/dota2/teams

List pro teams

Parameters

Name	In	Type	Required
page	query	integer	no
per_page	query	integer	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/teams

get/dota2/teams/{team_id}

Team detail

Parameters

Name	In	Type	Required
team_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/teams/{team_id}

get/dota2/teams/{team_id}/matches

Team match history

Parameters

Name	In	Type	Required
team_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/teams/{team_id}/matches

get/dota2/teams/{team_id}/players

Team roster

Parameters

Name	In	Type	Required
team_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/teams/{team_id}/players

get/dota2/teams/detail/{slug}

Rich team detail: roster + extras

Parameters

Name	In	Type	Required
slug	path	string	yes
force	query	boolean	no
by	query	string	no
fields	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/teams/detail/{slug}

get/dota2/teams/form/{slug}

Recent team form with badge strip

Parameters

Name	In	Type	Required
slug	path	string	yes
since_days	query	integer	no
limit	query	integer	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/teams/form/{slug}

get/dota2/teams/h2h/{a_slug}/vs/{b_slug}

Head-to-head between two teams

Parameters

Name	In	Type	Required
a_slug	path	string	yes
b_slug	path	string	yes
since_days	query	integer	no
recent_limit	query	integer	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/teams/h2h/{a_slug}/vs/{b_slug}

get/dota2/teams/liquipedia/{slug}

Liquipedia team roster live fetch

Parameters

Name	In	Type	Required
slug	path	string	yes
force	query	boolean	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/teams/liquipedia/{slug}

get/dota2/teams/portal

Liquipedia active pro teams with rosters

Parameters

Name	In	Type	Required
force	query	boolean	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/teams/portal

get/dota2/teams/portal/{slug}

Team roster from store (fast)

Parameters

Name	In	Type	Required
slug	path	string	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/teams/portal/{slug}

get/dota2/teams/portal/list

Liquipedia active teams list (no rosters)

Parameters

Name	In	Type	Required
force	query	boolean	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/teams/portal/list

Players

Individual player profiles, MMR, and rankings.

get/dota2/players

List Pros

Parameters

Name	In	Type	Required
page	query	integer	no
per_page	query	integer	no
team_id	query	string	no
country	query	string	no
position	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/players

get/dota2/players/{account_id}

Player Detail

Parameters

Name	In	Type	Required
account_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/players/{account_id}

get/dota2/players/{account_id}/form

Rolling player form by account id

Parameters

Name	In	Type	Required
account_id	path	integer	yes
windows	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/players/{account_id}/form

get/dota2/players/{account_id}/heroes

Player Hero Pool

Parameters

Name	In	Type	Required
account_id	path	integer	yes
limit	query	integer	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/players/{account_id}/heroes

get/dota2/players/{account_id}/matches

Player Recent Matches

Parameters

Name	In	Type	Required
account_id	path	integer	yes
limit	query	integer	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/players/{account_id}/matches

get/dota2/players/{slug}/ai-context

Bundled player context for AI-analysis prompts

Parameters

Name	In	Type	Required
slug	path	string	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/players/{slug}/ai-context

get/dota2/players/form/{handle}

Rolling player form (7/14/30d)

Parameters

Name	In	Type	Required
handle	path	string	yes
windows	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/players/form/{handle}

get/dota2/players/transfers

Player Transfers Root

Parameters

Name	In	Type	Required
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/players/transfers

Leagues & Tournaments

Browse all active Dota 2 leagues and premium tournaments.

get/dota2/leagues

List leagues

Parameters

Name	In	Type	Required
page	query	integer	no
per_page	query	integer	no
source	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/leagues

get/dota2/leagues/{league_id}

League By Id

Parameters

Name	In	Type	Required
league_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/leagues/{league_id}

get/dota2/leagues/{league_id}/detail

League Detail

Parameters

Name	In	Type	Required
league_id	path	integer	yes
liquipedia	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/leagues/{league_id}/detail

get/dota2/leagues/{league_id}/detail/brackets

Tournament brackets

Parameters

Name	In	Type	Required
league_id	path	integer	yes
liquipedia	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/leagues/{league_id}/detail/brackets

get/dota2/leagues/{league_id}/detail/broadcast

Tournament broadcasts

Parameters

Name	In	Type	Required
league_id	path	integer	yes
liquipedia	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/leagues/{league_id}/detail/broadcast

get/dota2/leagues/{league_id}/detail/infobox

Tournament infobox

Parameters

Name	In	Type	Required
league_id	path	integer	yes
liquipedia	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/leagues/{league_id}/detail/infobox

get/dota2/leagues/{league_id}/detail/matches

League Detail Matches

Parameters

Name	In	Type	Required
league_id	path	integer	yes
liquipedia	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/leagues/{league_id}/detail/matches

get/dota2/leagues/{league_id}/detail/participants

Tournament participants

Parameters

Name	In	Type	Required
league_id	path	integer	yes
liquipedia	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/leagues/{league_id}/detail/participants

get/dota2/leagues/{league_id}/detail/prize-pool

Tournament prize pool breakdown

Parameters

Name	In	Type	Required
league_id	path	integer	yes
liquipedia	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/leagues/{league_id}/detail/prize-pool

get/dota2/leagues/{league_id}/prize-pool

League Prize Pool

Parameters

Name	In	Type	Required
league_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/leagues/{league_id}/prize-pool

get/dota2/leagues/{league_id}/state

Live tournament state in one hop

Parameters

Name	In	Type	Required
league_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/leagues/{league_id}/state

get/dota2/liquipedia/tournament

Liquipedia Tournament By Slug

Parameters

Name	In	Type	Required
slug	query	string	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/liquipedia/tournament

get/dota2/tournaments

Tournaments

Parameters

Name	In	Type	Required
page	query	integer	no
per_page	query	integer	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/tournaments

get/dota2/tournaments/{slug}/qualifiers

Tournament Qualifiers

Parameters

Name	In	Type	Required
slug	path	string	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/tournaments/{slug}/qualifiers

get/dota2/tournaments/portal

Tournaments Portal

Parameters

Name	In	Type	Required
section	query	string	no
tier	query	string	no
include_qualifiers	query	boolean	no
include_show_matches	query	boolean	no
limit	query	string	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/tournaments/portal

get/dota2/tournaments/portal/grouped

Tournaments Portal Grouped

Parameters

Name	In	Type	Required
tier	query	string	no
include_show_matches	query	boolean	no
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/tournaments/portal/grouped

Heroes & Items

Reference data for all 127 heroes and the entire item catalog.

get/dota2/heroes

All heroes

Parameters

Name	In	Type	Required
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/heroes

get/dota2/heroes/{hero_id}

Hero

Parameters

Name	In	Type	Required
hero_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/heroes/{hero_id}

get/dota2/heroes/icons

Heroes Icons

Parameters

Name	In	Type	Required
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/heroes/icons

get/dota2/heroes/meta

Heroes Meta

Parameters

Name	In	Type	Required
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/heroes/meta

get/dota2/items

All items

Parameters

Name	In	Type	Required
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/items

get/dota2/items/{item_id}

Item detail

Parameters

Name	In	Type	Required
item_id	path	integer	yes
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/items/{item_id}

get/dota2/patch

Current Patch

Parameters

Name	In	Type	Required
authorization	header	string	no

Show curl example

curl -H "Authorization: Bearer dks_your_key" \
  https://api.dotascore.live/dota2/patch

API Reference

Authentication

Errors

Matches

Bookmaker Odds

Teams

Players

Leagues & Tournaments

Heroes & Items