Player stats
GET
/api/v1/player/{query}
Player StatsFreePremium
Maintainer:Alastor
uid or username.username is a new feature and is not always reliable. Searching player stats by player uid is more stable.Request
Path Params
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://marvelrivalsapi.com/api/v1/player/?season' \
--header 'x-api-key;'Response Response Example
200 - Success
{
"uid": 543511984,
"name": "ToernB",
"updates": {
"info_update_time": "5/7/2025, 3:29:57 PM",
"last_history_update": "7/22/2025, 7:32:54 AM",
"last_inserted_match": "7/22/2025, 6:50:22 AM",
"last_update_request": "7/22/2025, 2:03:19 PM"
},
"player": {
"uid": 543511984,
"level": "43",
"name": "ToernB",
"icon": {
"player_icon_id": "31027204",
"player_icon": "/players/heads/player_head_31027204.png"
},
"rank": {
"rank": "Silver II",
"image": "/ranked/silver.png",
"color": "#7B9196"
},
"team": {
"club_team_id": "934_80",
"club_team_mini_name": "TWOFID",
"club_team_type": "0"
},
"info": {
"completed_achievements": "102",
"login_os": "PC",
"rank_game_season": {
"1001001": {
"rank_game_id": 1,
"level": 10,
"rank_score": 3894.3651498707495,
"max_level": 10,
"max_rank_score": 3999.657859194941,
"update_time": 1736452160,
"win_count": 96,
"protect_score": 0,
"diff_score": -11.9277523497949
},
"1001002": {
"rank_game_id": 2,
"level": 11,
"rank_score": 4007.0633661602137,
"max_level": 12,
"max_rank_score": 4111.801296371733,
"update_time": 1739993667,
"win_count": 112,
"protect_score": 0,
"diff_score": -21.95033149810024
},
"1001003": {
"rank_game_id": 3,
"level": 13,
"rank_score": 4229.917649646161,
"max_level": 13,
"max_rank_score": 4229.917649646161,
"update_time": 1742684552,
"win_count": 9,
"protect_score": 0,
"diff_score": 33.70900847638222
},
"1001004": {
"rank_game_id": 4,
"level": 8,
"rank_score": 3680.757168414914,
"max_level": 8,
"max_rank_score": 3738.8533679365632,
"update_time": 1747238399,
"win_count": 29,
"protect_score": 0,
"diff_score": -21.507109301622677
},
"1001005": {
"rank_game_id": 5,
"level": 7,
"rank_score": 3645.419398799876,
"max_level": 8,
"max_rank_score": 3758.8646823447457,
"update_time": 1751639090,
"win_count": 8,
"protect_score": 2,
"diff_score": -22.433479474959313
},
"1001006": {
"rank_game_id": 6,
"level": 5,
"rank_score": 3440.2259335209114,
"max_level": 5,
"max_rank_score": 3441.7012746847704,
"update_time": 1753182074,
"win_count": 20,
"protect_score": 3,
"diff_score": 32.19930621460708
}
}
}
},
"isPrivate": false,
"overall_stats": {
"total_matches": 55,
"total_wins": 20,
"unranked": {
"total_matches": 0,
"total_wins": 0,
"total_assists": 0,
"total_deaths": 0,
"total_kills": 0,
"total_time_played": "0m 0s",
"total_time_played_raw": 0,
"total_mvp": 0,
"total_svp": 0
},
"ranked": {
"total_matches": 55,
"total_wins": 20,
"total_assists": 266,
"total_deaths": 458,
"total_kills": 867,
"total_time_played": "9h 39m 40s",
"total_time_played_raw": 34780.11118102074,
"total_mvp": 0,
"total_svp": 3
}
},
"match_history": [
{
"match_uid": "6711581_1753181422_1272091_11001_22",
"map_id": 1272,
"map_thumbnail": "/rivals/maps/map_1272.png",
"duration": 480.09607696533203,
"season": 5,
"winner_side": 1,
"mvp_uid": 2081021746,
"svp_uid": 1364024944,
"match_time_stamp": 1753182074,
"play_mode_id": 0,
"game_mode_id": 2,Modified at 2025-07-24 14:15:15