Player match history

GET

/api/v1/player/{query}/match-history

Player Match History

Maintainer:Alastor

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.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://marvelrivalsapi.com/api/v1/player//match-history?season&skip&game_mode' \
--header 'x-api-key;'

Response Example

200 - Example 1

{
    "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
                }
            }
        }
    ]
}

Request

Path Params

query

string

required

The unique player identifier (either UID or username).

Example:

player123

Query Params

season

integer

optional

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

Example:

skip

integer

optional

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

Example:

game_mode

integer

optional

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

Example:

Header Params

x-api-key

string

required

The API key for authorization. It is necessary to provide a valid API key to access the data.

Example:

your-api-key-here

Responses

🟢200OK

application/json

Successfully retrieved match history for the player

Body

match_history

array [object {13}]

optional

A list of the player's match history with detailed stats.

match_map_id

integer

optional

The ID of the map where the match took place.

Example:

map_thumbnail

string

optional

URL of the map's thumbnail image.

Example:

/rivals/maps/map_1.png

match_play_duration

string

optional

The duration of the match in a human-readable format.

Example:

15 minutes

match_season

integer

optional

The season number of the match.

Example:

1.5

match_uid

string

optional

The unique identifier of the match.

Example:

match12345

match_winner_side

string

optional

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

Example:

mvp_uid

string

optional

The unique ID of the MVP player.

Example:

player123

svp_uid

string

optional

The unique ID of the SVP player.

Example:

player456

score_info

object

optional

Additional dynamic score information of the match.

Example:

{"score":10,"score_info":"Some additional data"}

match_time_stamp

integer

optional

The timestamp when the match took place.

Example:

1675058998

play_mode_id

integer

optional

The ID of the play mode.

Example:

game_mode_id

integer

optional

The ID of the game mode.

Example:

match_player

object

optional

Information about the player's performance in the match.

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

Modified at 2025-07-23 14:35:31

Search match

Player match history v2