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

List All

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}

Detail

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}

get/dota2/matches/feed

Matches Feed

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/past

Past

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/past

get/dota2/matches/running

Running

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/running

get/dota2/matches/upcoming

Upcoming

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/upcoming

Bookmaker Odds

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

get/dota2/odds

Dota 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/raw

Dota Odds Raw

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 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 Matches

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 Players

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

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
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}/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

Leagues & Tournaments

Browse all active Dota 2 leagues and premium tournaments.

get/dota2/leagues

Leagues

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/leagues

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/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

Heroes & Items

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

get/dota2/heroes

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

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

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

Service

Health and discovery endpoints.

get/

Root

Show curl example

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

get/health

Health

Show curl example

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

API Reference

Authentication

Errors

Matches

Bookmaker Odds

Teams

Players

Leagues & Tournaments

Heroes & Items

Service