Player match history v2

GET

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

Player Match Historyv2

Maintainer:Alastor

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

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success

{
    "match_history": [
        {
            "match_map_id": 1217,
            "map_thumbnail": "/rivals/maps/map_1217.png",
            "match_play_duration": "8m 59s",
            "match_season": "1.5",
            "match_uid": "4890883_1741845325_1565_11001_10",
            "match_winner_side": 0,
            "mvp_uid": 445990150,
            "svp_uid": 538661026,
            "score_info": null,
            "match_time_stamp": 1741845957,
            "play_mode_id": 0,
            "game_mode_id": 1,
            "match_player": {
                "assists": 5,
                "kills": 8,
                "deaths": 9,
                "is_win": {
                    "score": 0,
                    "is_win": false
                },
                "disconnected": false,
                "player_uid": 632183034,
                "camp": 1,
                "score_info": {
                    "add_score": -35.36539720815472,
                    "level": 1,
                    "new_level": 1,
                    "new_score": 3194.0073244099885
                },
                "player_hero": {
                    "hero_id": 1047,
                    "hero_name": "jeff the land shark",
                    "hero_type": "/heroes/transformations/jeff-the-land-shark-headbig-0.webp",
                    "kills": 8,
                    "deaths": 9,
                    "assists": 5,
                    "play_time": {
                        "raw": 539.3805547300726,
                        "formatted": "8m 59s"
                    },
                    "total_hero_damage": 6852.4064083099365,
                    "total_damage_taken": 6883.935603141785,
                    "total_hero_heal": 8338.68634223938
                }
            }
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 40,
        "total_matches": 185,
        "total_pages": 5,
        "has_more": true
    }
}

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 current season.

Example:

page

integer

optional

The page number for pagination. Defaults to 1 if not specified.

Example:

limit

integer

optional

The number of matches per page. Defaults to 40 if not specified.

Example:

skip

integer

optional

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

game_mode

integer

optional

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

timestamp

integer

optional

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

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.

map_thumbnail

string

optional

URL of the map's thumbnail image.

match_play_duration

string

optional

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

match_season

string

optional

The season number of the match.

match_uid

string

optional

The unique identifier of the match.

match_winner_side

integer

optional

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

mvp_uid

integer

optional

The unique ID of the MVP player.

svp_uid

integer

optional

The unique ID of the SVP player.

score_info

null

optional

Additional dynamic score information of the match.

match_time_stamp

integer

optional

The timestamp when the match took place.

play_mode_id

integer

optional

The ID of the play mode.

game_mode_id

integer

optional

The ID of the game mode.

match_player

object

optional

Information about the player's performance in the match.

pagination

object

required

page

integer

required

limit

integer

required

total_matches

integer

required

total_pages

integer

required

has_more

boolean

required

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

Modified at 2025-07-24 14:17:22

Player match history

Search player