WebAPI/GetMatchHistory

URL

GET http://api.steampowered.com/IDOTA2Match_<ID>/GetMatchHistory/v1

Method-specific parameters

hero_id (Optional) (uint32)

A list of hero IDs can be found via the GetHeroes method.

game_mode (Optional) (uint32)

0 - None

1 - All Pick

2 - Captain's Mode

3 - Random Draft

4 - Single Draft

5 - All Random

6 - Intro

7 - Diretide

8 - Reverse Captain's Mode

9 - The Greeviling

10 - Tutorial

11 - Mid Only

12 - Least Played

13 - New Player Pool

14 - Compendium Matchmaking

16 - Captain's Draft

skill (Optional) (uint32)

Skill bracket for the matches (Ignored if an account ID is specified).

0 - Any

1 - Normal

2 - High

3 - Very High

date_min (Optional) (uint32)

Minimum date range for returned matches (unix timestamp, rounded to the nearest day).

date_max (Optional) (uint32)

Maximum date range for returned matches (unix timestamp, rounded to the nearest day).

min_players (Optional) (string)

Minimum amount of players in a match for the match to be returned.

account_id (Optional) (string)

32-bit account ID.

league_id (Optional) (string)

Only return matches from this league. A list of league IDs can be found via the GetLeagueListing method.

start_at_match_id (Optional) (string)

Start searching for matches equal to or older than this match ID.

matches_requested (Optional) (string)

Amount of matches to include in results (default: 25).

tournament_games_only (Optional) (string)

Whether to limit results to tournament matches.

Result data

result

status

1 - Success

15 - Cannot get match history for a user that hasn't allowed it.

statusDetail

A message explaining the status, should status not be 1.

num_results

The number of matches in this response.

total_results

The total number of matches for the query.

results_remaining

The number of matches left for this query.

matches

A list of matches.

match_id

The matches unique ID.

match_seq_num

A 'sequence number', representing the order in which matches were recorded.

start_time

Unix timestamp of when the match began.

lobby_type

-1 - Invalid

0 - Public matchmaking

1 - Practise

2 - Tournament

3 - Tutorial

4 - Co-op with bots.

5 - Team match

6 - Solo Queue

players

The list of players within the match.

account_id

32-bit account ID.

player_slot

See #Player Slot below.

hero_id

The hero's unique ID. A list of hero IDs can be found via the GetHeroes method.

Player Slot

A player's slot is returned via an 8-bit unsigned integer. The first bit represent the player's team, false if Radiant and true if dire. The final three bits represent the player's position in that team, from 0-4.

   ┌─────────────── Team (false if Radiant, true if Dire).
   │ ┌─┬─┬─┬─────── Not used.
   │ │ │ │ │ ┌─┬─┬─ The position of a player within their team (0-4).
   │ │ │ │ │ │ │ │
   0 0 0 0 0 0 0 0