Match History v1

GET https://marvelrivalsapi.com/api/v1/player/:query/match-history

This endpoint retrieves the match history of a player based on their unique identifier (UID) or username. It allows filtering by season, skip value, and game mode.

Headers

Name
Value

Content-Type

application/json

x-api-key*

YOUR API KEY

Query Parameters

Name
Type
Required
Description

query*

string

✔️

The unique identifier of the player (could be uid or username).

season

integer

The season to retrieve match history for. Defaults to current season

skip

integer

The number of matches to skip (pagination). Defaults to 20.

game_mode

integer

The game mode to filter matches by. Defaults to 0.

timestamp

integer

Filter matches by timestamp. Only includes matches after the given timestamp.

Example Requests

curl -X GET "https://marvelrivalsapi.com/api/v1/player/Sypeh/match-history"
     -H "x-api-key: YOUR_API_KEY"

Response

{
  "match_history": [
    {
      "match_map_id": 1,
      "map_thumbnail": "/rivals/maps/map_1.png",
      "match_play_duration": "15 minutes",
      "match_season": 1.5,
      "match_uid": "match12345",
      "match_winner_side": "A",
      "mvp_uid": "player123",
      "svp_uid": "player456",
      "score_info": {
        "score": 10,
        "score_info": "Some additional data"
      },
      "match_time_stamp": 1675058998,
      "play_mode_id": 1,
      "game_mode_id": 1,
      "match_player": {
        "assists": 3,
        "kills": 5,
        "deaths": 2,
        "is_win": true,
        "disconnected": false,
        "player_uid": "player123",
        "camp": "A",
        "score_info": {
          "score": 100
        },
        "player_hero": {
          "hero_id": 101,
          "hero_name": "Warrior",
          "hero_thumbnail": "/heroes/warrior.png",
          "kills": 3,
          "deaths": 1,
          "assists": 2,
          "play_time": "10 minutes",
          "total_hero_damage": 5000,
          "total_damage_taken": 3000,
          "total_hero_heal": 1500
        }
      }
    }
  ]
}

Response Field Descriptions

Field
Type
Description

match_season

Number

The season of the match (e.g., 1.5).

match_uid

String

Unique identifier for the match (e.g., "match12345").

match_winner_side

String

The winning side of the match (e.g., "A").

mvp_uid

String

Unique identifier for the MVP player (e.g., "player123").

svp_uid

String

Unique identifier for the SVP player (e.g., "player456").

score_info.score

Number

The score of the match (e.g., 10).

score_info.score_info

String

Additional information about the score (e.g., "Some additional data").

match_time_stamp

Number

Timestamp of the match (e.g., 1675058998).

play_mode_id

Number

The play mode ID used in the match (e.g., 1).

game_mode_id

Number

The game mode ID used in the match (e.g., 1).

match_player.assists

Number

The number of assists by the player in the match (e.g., 3).

match_player.kills

Number

The number of kills by the player in the match (e.g., 5).

match_player.deaths

Number

The number of deaths by the player in the match (e.g., 2).

match_player.is_win

Boolean

Whether the player won the match (e.g., true).

match_player.disconnected

Boolean

Whether the player disconnected during the match (e.g., false).

match_player.player_uid

String

Unique identifier for the player (e.g., "player123").

match_player.camp

String

The camp of the player (e.g., "A").

match_player.score_info.score

Number

The score of the player in the match (e.g., 100).

match_player.player_hero.hero_id

Number

ID of the hero played by the player (e.g., 101).

match_player.player_hero.hero_name

String

Name of the hero played by the player (e.g., "Warrior").

match_player.player_hero.hero_thumbnail

String

URL or path to the hero's image (e.g., "/heroes/warrior.png").

match_player.player_hero.kills

Number

The number of kills by the player's hero (e.g., 3).

match_player.player_hero.deaths

Number

The number of deaths by the player's hero (e.g., 1).

match_player.player_hero.assists

Number

The number of assists by the player's hero (e.g., 2).

match_player.player_hero.play_time

String

Time spent playing with the hero (e.g., "10 minutes").

match_player.player_hero.total_hero_damage

Number

Total damage dealt by the player's hero (e.g., 5000).

match_player.player_hero.total_damage_taken

Number

Total damage taken by the player's hero (e.g., 3000).

match_player.player_hero.total_hero_heal

Number

Total healing done by the player's hero (e.g., 1500).

Last updated

Was this helpful?