get_legacy_match_history {SC2API}

Legacy API - Profile Match History

Description

Provides information about a profile's recent match history (last 25 matches, win/loss, timestamp, etc.).

Usage

get_legacy_match_history(region_id, realm_id, profile_id, host_region = "us")

Arguments

region_id

A numeric argument indicating the region of the profile.

• 1 = US Region

• 2 = EU Region

• 3 = KR/TW Region

• 5 = CN Region

realm_id

A numeric argument indicating the realm of the profile. A realm is a subset of the region.

• US Region

  • 1 = US

  • 2 = LatAm

• EU Region

  • 1 = Europe

  • 2 = Russia

• KR/TW Region

  • 1 = Korea

  • 2 = Taiwan

profile_id

A unique, numeric identifier for an individual's profile.

host_region

The host region that the API call will be sent to. For most API calls, the same data will be returned regardless of which region the request is sent to. Must be one of "us", "eu", "kr", "tw", "cn". For more information on regionality, refer to Regionality and APIs.

Note

Although this is a legacy API call, there is no other call available to obtain a profile's match history.

References

• Blizzard Community API Documentation

• Regionality and APIs

See Also

Other legacy API calls: get_legacy_achievements(), get_legacy_ladders(), get_legacy_ladder(), get_legacy_profile(), get_legacy_rewards()

Examples

# Obtain recent 1v1 results for a profile in the U.S. region
try({
    matches <- get_legacy_match_history(region_id = 1, realm_id = 1, profile_id = 4716773)
    matches[matches$type=='1v1',"decision"]
})