Search match

GET

/api/v1/match/{match_uid}

Player Match History

Maintainer:Alastor

This endpoint retrieves match data for a specific match identified by the match_uid. It processes the match details and player stats.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://marvelrivalsapi.com/api/v1/match/' \
--header 'x-api-key;'

Response Example

200 - Example 1

{
    "match_details": {
        "match_uid": "abcd1234",
        "game_mode": {
            "game_mode_id": 1,
            "game_mode_name": "Deathmatch"
        },
        "replay_id": "replay12345",
        "mvp_uid": "player123",
        "mvp_hero_id": 101,
        "svp_uid": "player456",
        "svp_hero_id": 102,
        "dynamic_fields": {},
        "match_players": [
            {
                "player_uid": "player123",
                "nick_name": "Player1",
                "player_icon": "/icons/player1.jpg",
                "camp": "A",
                "cur_hero_id": 101,
                "cur_hero_icon": "/heroes/hero101.jpg",
                "is_win": true,
                "kills": 5,
                "deaths": 3,
                "assists": 2,
                "total_hero_damage": 3000,
                "total_hero_heal": 1500,
                "total_damage_taken": 2000,
                "player_heroes": [
                    {
                        "hero_id": 101,
                        "play_time": 300,
                        "kills": 3,
                        "deaths": 1,
                        "assists": 2,
                        "session_hit_rate": 75.5,
                        "hero_icon": "/heroes/hero/101_icon.jpg"
                    }
                ]
            }
        ]
    }
}

Request

Path Params

match_uid

string

required

The unique identifier of the match.

Example:

abcd1234

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

Successful response with match details

Body

match_details

object

optional

The processed match details and player stats.

match_uid

string

optional

The unique identifier for the match.

Example:

abcd1234

game_mode

object

optional

replay_id

string

optional

The replay ID for the match.

Example:

replay12345

mvp_uid

string

optional

The unique ID of the MVP player.

Example:

player123

mvp_hero_id

integer

optional

The hero ID of the MVP player.

Example:

101

svp_uid

string

optional

The unique ID of the SVP player.

Example:

player456

svp_hero_id

integer

optional

The hero ID of the SVP player.

Example:

102

dynamic_fields

object

optional

Any dynamic data associated with the match.

match_players

array [object {14}]

optional

List of players in the match with their stats.

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

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

Search map

Player match history