### List Maps Response Example Source: https://docs.marvelrivalsapi.com/list-maps-19312747e0 Example JSON response for the 'List maps' endpoint, showing total maps and a sample map object. ```JSON { "total_maps": 50, "maps": [ { "id": "map-001", "name": "Sky Arena", "type": "1v1", "description": "A floating island with dynamic obstacles.", "image": "maps/sky-arena.webp" } ] } ``` -------------------------------- ### Get Hero Request Example Source: https://docs.marvelrivalsapi.com/search-hero-19312740e0 Use this cURL command to fetch hero data from the API. Ensure you include your API key in the x-api-key header. ```shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/heroes/hero/' \ --header 'x-api-key;' ``` -------------------------------- ### Player Data Response Example Source: https://docs.marvelrivalsapi.com/player-stats-v2-19465518e0 Example JSON response for a successful player data request. This includes player statistics, rank, and update times. ```json { "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/23/2025, 10:03:05 AM" }, "player": { "uid": 543511984, "level": "43", "name": "ToernB", "icon": { "player_icon_id": "31027204", "player_icon": "/players/heads/player_head_31027204.png", "banner": "/premium/nameplates/31027204_banner.webp?expires=1753283659&signature=4f72c4c5b018f903825681bd73fc93313b4a24840fa7d3d5023edefd52587393" }, "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 } } }, "rank": { "rank": "Silver II", "score": "3,440", "unit": "RS", "icon": "/classes/silver.png", "color": "#7B9196", "peak_rank": { "rank": "Silver II", "score": "3,441", "unit": "RS", "icon": "/classes/silver.png", "color": "#7B9196" } } }, "isPrivate": false, "overall_stats": { "total_matches": 55, "total_wins": { "wins": 20, "percentile_raw": 22, "percentile": "Bottom 22.0%", "win_percentage": { "percentile_raw": 36.4, "percentile": 1, "placement": "Bottom 1.0%" } }, "total_play_time": { "time_played": 34780.11118102074, "playtime": "9h 39m 40s" }, "per_minute": { "total_damage_per_minute": 1224, ``` -------------------------------- ### List Heroes API Response Example Source: https://docs.marvelrivalsapi.com/list-heroes-19312739e0 Example of a successful JSON response when listing heroes. It includes hero details such as ID, name, role, abilities, and image URL. ```json { "status": "success", "heroes": [ { "id": "hero_001", "name": "Iron Man", "alias": "Tony Stark", "role": "DPS", "abilities": [ { "ability_name": "Repulsor Blast", "cooldown": 5, "description": "Fires a repulsor beam at enemies." } ], "imageUrl": "/heroes/cards/ironman.png" } ] } ``` -------------------------------- ### Item Search Response Example Source: https://docs.marvelrivalsapi.com/search-item-19312746e0 Example of a successful JSON response when searching for an item. It includes item details such as ID, name, quality, type, and icon. ```JSON { "item": { "id": "30000001", "name": "Rivals", "quality": "BLUE", "type": "Nameplate", "applicable_hero": "0", "icon": "items/rivals-30000001-icon.webp", "slug": "rivals-30000001", "description": null } } ``` -------------------------------- ### Player Leaderboard Response Example Source: https://docs.marvelrivalsapi.com/player-leaderboard-19465491e0 Example JSON response for the player leaderboard endpoint, showing player scores, UIDs, names, icons, and rank details. ```json { "page": 1, "limit": 25, "total_players": 500, "total_pages": 20, "players": [ { "score": 2205113, "uid": "1362318547", "name": "pølly", "icon": { "player_icon_id": "31022203", "player_icon": "/players/heads/player_head_31022203.png" }, "rank": { "rank": { "rank": "Eternity", "image": "/ranked/eternity.png", "color": "#FF4F4D" }, "win_rate": "68.9%", "max_level": 23, "rank_score": 5113.6921849402, "protect_score": 0, "diff_score": 16.227694418965, "season_number": 2, "win_count": 73, "level": 22, "max_rank_score": 5113.6921849402, "season_max_level": 23, "battle_count": 106 } }, { "score": 2205109, "uid": "189146510", "name": "рokey", "icon": { "player_icon_id": "31016204", "player_icon": "/players/heads/player_head_31016204.png" }, "rank": { "rank": { "rank": "Eternity", "image": "/ranked/eternity.png", "color": "#FF4F4D" }, "win_rate": "65.7%", "max_level": 23, "rank_score": 5109.0443056035, "protect_score": 0, "diff_score": 12.498423710025, "season_number": 2, "win_count": 90, "level": 22, "max_rank_score": 5109.0443056035, "season_max_level": 23, "battle_count": 137 } }, { "score": 2205103, "uid": "1822797559", "name": "cооper", "icon": { "player_icon_id": "31038204", "player_icon": "/players/heads/player_head_31038204.png" }, "rank": { "rank": { "rank": "One Above All", "image": "/ranked/one_above_all.png", "color": "#FF4F4D" }, "win_rate": "72%", "max_level": 23, "rank_score": 5103.0905286786, "protect_score": 0, "diff_score": 11.902376239289, "season_number": 2, "win_count": 90, "level": 23, "max_rank_score": 5103.0905286786, "season_max_level": 23, "battle_count": 125 } }, ] } ``` -------------------------------- ### Game Versions Response Example Source: https://docs.marvelrivalsapi.com/list-game-versions-19312737e0 A sample JSON response structure returned by the /api/v1/game-versions endpoint. ```JSON { "total_versions": 8, "formatted_versions": [ { "version": 20241210, "release": "Dec 10, 2024", "patchNotesUrl": "/api/v1/patch-notes/20241210" } ] } ``` -------------------------------- ### List items response example Source: https://docs.marvelrivalsapi.com/list-items-19312745e0 A successful 200 OK response containing the total count and a list of item objects. ```JSON { "total_items": 100, "items": [ { "id": "30000001", "name": "Rivals", "quality": "BLUE", "type": "Nameplate", "applicable_hero": "0", "icon": "items/rivals-30000001-icon.webp", "slug": "rivals-30000001", "description": null } ] } ``` -------------------------------- ### Search hero costume request Source: https://docs.marvelrivalsapi.com/search-hero-costume-19312744e0 Example cURL command to retrieve costume details for a specific hero. ```shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/heroes/hero//costume/' \ --header 'x-api-key;' ``` -------------------------------- ### Retrieve Hero Stats Request Source: https://docs.marvelrivalsapi.com/hero-stats-19312741e0 Example request for fetching hero statistics using cURL. ```shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/heroes/hero//stats' \ --header 'x-api-key;' ``` -------------------------------- ### Retrieve Battle Pass Data Source: https://docs.marvelrivalsapi.com/battlepass-19312738e0 Example request for fetching battle pass information using cURL. ```Shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/battlepass?season' \ --header 'x-api-key;' ``` -------------------------------- ### Battle Pass Response Schema Source: https://docs.marvelrivalsapi.com/battlepass-19312738e0 Example JSON response structure for the battle pass endpoint. ```JSON { "season": 1, "season_name": "Rivals Season 1", "items": [ { "name": "All-Butcher", "image": "/battlepass/1/all-butcher.jpg", "cost": "Unlock To Claim", "isLuxury": true } ] } ``` -------------------------------- ### Search Achievement Request Source: https://docs.marvelrivalsapi.com/search-achievement-19312730e0 Example request for searching achievements using cURL. ```shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/achievement/' \ --header 'x-api-key;' ``` -------------------------------- ### GET /api/v1/heroes/leaderboard/{query} Source: https://docs.marvelrivalsapi.com/hero-leaderboard-19312742e0 Retrieves the leaderboard for a specific hero, allowing for platform-based filtering. ```APIDOC ## GET /api/v1/heroes/leaderboard/{query} ### Description This endpoint retrieves the leaderboard for a specific hero based on their name or ID, and allows filtering the leaderboard by platform (PC, PS, Xbox). ### Method GET ### Endpoint /api/v1/heroes/leaderboard/{query} ### Parameters #### Path Parameters - **query** (string) - Required - The name or ID of the hero. #### Query Parameters - **platform** (string) - Optional - Filter the leaderboard by platform (PC, PS, Xbox). ### Request Example curl --location --request GET 'https://marvelrivalsapi.com/api/v1/heroes/leaderboard/?platform' \ --header 'x-api-key;' ### Response #### Success Response (200) - **hero_name** (string) - The name of the hero. - **platform** (string) - The platform filtered. - **leaderboard** (array) - List of ranked players. #### Response Example { "hero_name": "Ironman", "platform": "pc", "leaderboard": [ { "rank": 1, "player_name": "PlayerOne", "score": 10000, "platform": "pc" } ] } ``` -------------------------------- ### Search map request Source: https://docs.marvelrivalsapi.com/search-map-19313158e0 Example cURL command to retrieve map information using an API key. ```shell curl --location --request GET 'https://marvelrivalsapi.com/api/v2/map/' \ --header 'x-api-key;' ``` -------------------------------- ### Player Match History Response Example Source: https://docs.marvelrivalsapi.com/player-match-history-19312749e0 This is a successful 200 OK response for the Player Match History endpoint, showing the structure of the returned match data. ```json { "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 } } } ] } ``` -------------------------------- ### Search Achievement Response Source: https://docs.marvelrivalsapi.com/search-achievement-19312730e0 Example JSON response body returned when an achievement is successfully found. ```json { "achievement": { "name": "Sticking Around", "category": "Exploration", "points": 100, "icon": "/achievements/Sticking_Around.webp", "mission": "Unlocked by discovering all hidden locations." } } ``` -------------------------------- ### Retrieve items list request Source: https://docs.marvelrivalsapi.com/list-items-19312745e0 Example request using cURL to fetch items from the API with optional query parameters for filtering and pagination. ```Shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/items?type&page&limit' \ --header 'x-api-key;' ``` -------------------------------- ### List Maps cURL Request Source: https://docs.marvelrivalsapi.com/list-maps-19312747e0 Example of how to list all available maps using a cURL request. Includes optional pagination parameters. ```Shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/maps?page&limit' \ --header 'x-api-key;' ``` -------------------------------- ### Hero Stats Response Schema Source: https://docs.marvelrivalsapi.com/hero-stats-19312741e0 Example JSON response body containing hero performance metrics. ```json { "hero_id": 1032, "hero_name": "squirrel girl", "hero_icon": "/heroes/transformations/squirrel-girl-headbig-0.webp", "matches": 1952, "wins": 829, "k": 14.922131147540984, "d": 5.543032786885246, "a": 5.136782786885246, "play_time": "266h 52m 18s", "total_hero_damage": 34114415.0734396, "total_hero_heal": 9.024993896484375, "total_damage_taken": 13013868.561632827, "session_hit_rate": 0.373334447668276, "solo_kill": 1.8790983606557377 } ``` -------------------------------- ### Hero Leaderboard Response Schema Source: https://docs.marvelrivalsapi.com/hero-leaderboard-19312742e0 Example JSON response structure containing hero name, platform, and a list of ranked player entries. ```json { "hero_name": "Ironman", "platform": "pc", "leaderboard": [ { "rank": 1, "player_name": "PlayerOne", "score": 10000, "platform": "pc" } ] } ``` -------------------------------- ### Search Match Request Source: https://docs.marvelrivalsapi.com/search-match-19312748e0 Example cURL command to retrieve match data using a specific API key. ```shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/match/' \ --header 'x-api-key;' ``` -------------------------------- ### Patch Balances Response Schema Source: https://docs.marvelrivalsapi.com/list-balances-19312731e0 Example JSON response structure returned by the /api/v1/balances endpoint. ```JSON { "total_patches": 50, "formatted_patches": [ { "patchTitle": "Marvel Rivals Version 20250214 balances", "patchDate": "2025-02-14", "patchType": "balances", "previewText": "This update includes new features and bug fixes.", "imagePath": "/images/patches/patch_20250214_1.jpg", "fullContent": "Details of the balance.", "htmlContent": "

Details in HTML format.

" } ] } ``` -------------------------------- ### Category Schema Example Source: https://docs.marvelrivalsapi.com/category-8158633d0 This is a sample JSON schema for a category object. It includes an ID and a name field. ```json { "id": 1, "name": "string" } ``` -------------------------------- ### Update Player Request Source: https://docs.marvelrivalsapi.com/update-player-19312752e0 Example cURL command to trigger a player data update. Requires an API key in the header. ```shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/player//update' \ --header 'x-api-key;' ``` -------------------------------- ### Get Player Leaderboard Source: https://docs.marvelrivalsapi.com/player-leaderboard-19465491e0 Retrieves the player leaderboard with pagination and filtering options. Requires API key for authentication. ```curl curl --location --request GET 'https://marvelrivalsapi.com/api/v2/players/leaderboard?page=&limit=&device=&season=' ``` -------------------------------- ### GET /api/v1/game-versions Source: https://docs.marvelrivalsapi.com/list-game-versions-19312737e0 Retrieves all available game versions with optional pagination and the option to filter for the current version, including corresponding patch notes for each version. ```APIDOC ## GET /api/v1/game-versions ### Description Retrieves all available game versions with optional pagination and the option to filter for the current version, including corresponding patch notes for each version. ### Method GET ### Endpoint /api/v1/game-versions ### Parameters #### Query Parameters - **page** (integer) - Optional - Page number for pagination - **limit** (integer) - Optional - Number of results per page - **current** (boolean) - Optional - Filter for the current version ### Request Example ``` curl --location --request GET 'https://marvelrivalsapi.com/api/v1/game-versions?page&limit¤t' \ --header 'x-api-key:' ``` ### Response #### Success Response (200) - **total_versions** (integer) - Total count of versions - **formatted_versions** (array) - List of version objects #### Response Example { "total_versions": 8, "formatted_versions": [ { "version": 20241210, "release": "Dec 10, 2024", "patchNotesUrl": "/api/v1/patch-notes/20241210" } ] } ``` -------------------------------- ### Search dev diary request Source: https://docs.marvelrivalsapi.com/search-dev-diary-19312734e0 Example cURL command to retrieve a specific dev diary entry using an API key. ```shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/dev-diary/' \ --header 'x-api-key;' ``` -------------------------------- ### GET /api/v2/player/ Source: https://docs.marvelrivalsapi.com/player-stats-v2-19465518e0 Retrieves comprehensive player profile information, including rank history, match statistics, and account status. ```APIDOC ## GET /api/v2/player/ ### Description Retrieves detailed player profile data including rank, match history, and account information. ### Method GET ### Endpoint https://marvelrivalsapi.com/api/v2/player/?season ### Parameters #### Query Parameters - **season** (string) - Optional - The specific season identifier for rank data. ### Request Example curl --location --request GET 'https://marvelrivalsapi.com/api/v2/player/?season' \ --header 'x-api-key:' ### Response #### Success Response (200) - **uid** (integer) - Unique player identifier - **name** (string) - Player display name - **player** (object) - Detailed player info including rank and team - **overall_stats** (object) - Aggregated match and performance statistics #### Response Example { "uid": 543511984, "name": "ToernB", "player": { "level": "43", "rank": { "rank": "Silver II", "score": "3,440" } }, "overall_stats": { "total_matches": 55 } } ``` -------------------------------- ### Get Player Data Request Source: https://docs.marvelrivalsapi.com/player-stats-v2-19465518e0 Use this cURL command to request player data for a given season. Ensure the 'x-api-key' header is correctly populated. ```shell curl --location --request GET 'https://marvelrivalsapi.com/api/v2/player/?season' \ --header 'x-api-key;' ``` -------------------------------- ### Costume API response structure Source: https://docs.marvelrivalsapi.com/list-costumes-19312743e0 Example JSON response containing costume details such as ID, name, icon, rarity, description, and appearance. ```JSON [ { "id": "costume_001", "name": "Ironman Mark 1", "icon": "/costumes/loki-1016001.png", "rarity": "Rare", "description": "The original Ironman suit with a rough, industrial design.", "appearance": "A shiny metallic suit with a red and gold color scheme." } ] ``` -------------------------------- ### Authentication Overview Source: https://docs.marvelrivalsapi.com/authentication-1287038m0 Explains the requirement for an API key and how to include it in requests. ```APIDOC ## Authentication ### Description All requests to the Marvel Rivals API must be authenticated using an API key. This key is used to identify your application, enforce rate limits, and determine your access tier. Requests without a valid key will return a 401 Unauthorized error. ### How to Get Your API Key 1. Visit https://marvelrivalsapi.com/dashboard/settings 2. Sign in or create an account 3. Click "Generate Key" ### Using Your API Key Include the key in the `x-api-key` header of every request. ### Request Example ```bash curl -X GET "https://marvelrivalsapi.com/api/v1/maps" \ -H "x-api-key: YOUR_API_KEY_HERE" ``` ``` -------------------------------- ### GET /schemas/tag Source: https://docs.marvelrivalsapi.com/tag-8158634d0 Retrieves information about a specific tag schema used within the API. ```APIDOC ## GET /schemas/tag ### Description Retrieves the definition of a tag object. ### Method GET ### Endpoint /schemas/tag ### Response #### Success Response (200) - **id** (integer) - Tag ID - **name** (string) - Tag Name #### Response Example { "id": 1, "name": "string" } ``` -------------------------------- ### GET /api/v1/achievements Source: https://docs.marvelrivalsapi.com/list-achievements-19312729e0 Retrieves a paginated list of all achievements currently obtainable in Marvel Rivals. ```APIDOC ## GET /api/v1/achievements ### Description List all current achievements obtainable in Marvel Rivals. Supports filtering and pagination. ### Method GET ### Endpoint /api/v1/achievements ### Parameters #### Query Parameters - **filter** (string) - Optional - Filter criteria for achievements - **page** (integer) - Optional - Page number for pagination - **limit** (integer) - Optional - Number of items per page ### Request Example ```bash curl --location --request GET 'https://marvelrivalsapi.com/api/v1/achievements?filter&page&limit' \ --header 'x-api-key:' ``` ### Response #### Success Response (200) - **total_achievements** (integer) - Total count of achievements - **achievements** (array) - List of achievement objects #### Response Example ```json { "total_achievements": 100, "achievements": [ { "id": "30000001", "name": "Rivals", "category": "Combat", "points": 50, "icon": "achievements/rivals-30000001-icon.webp" } ] } ``` ``` -------------------------------- ### List Dev Diaries API Request (cURL) Source: https://docs.marvelrivalsapi.com/list-dev-diaries-19312733e0 Example of how to list all available dev diaries using cURL. Includes optional pagination parameters and an API key header. ```shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/dev-diaries?page&limit' \ --header 'x-api-key;' ``` -------------------------------- ### GET /categories Source: https://docs.marvelrivalsapi.com/category-8158633d0 Retrieves a list of categories used within the game data schemas. ```APIDOC ## GET /categories ### Description Retrieves a list of categories. ### Method GET ### Endpoint /categories ### Response #### Success Response (200) - **id** (integer) - The unique identifier for the category. - **name** (string) - The name of the category. #### Response Example { "id": 1, "name": "string" } ``` -------------------------------- ### JSON Response for Balance Details Source: https://docs.marvelrivalsapi.com/search-balance-19312732e0 This is an example of a successful JSON response when retrieving balance details. It includes ID, title, date, overview, full content, and image path. ```JSON { "id": "20230201", "title": "Version 20230201: New Features and Fixes", "date": "2023-02-01", "overview": "This update includes new features and several bug fixes.", "fullContent": "

New Features

Several new features have been added...

", "imagePath": "/patches/patch-20230201-image.jpg" } ``` -------------------------------- ### GET /api/v1/items Source: https://docs.marvelrivalsapi.com/list-items-19312745e0 Retrieves a list of items from the game, supporting filtering by type and pagination. ```APIDOC ## GET /api/v1/items ### Description This endpoint retrieves a list of items. You can filter the items by type (e.g., emote, mvp, nameplate, spray) and apply pagination to control the number of items returned. ### Method GET ### Endpoint /api/v1/items ### Parameters #### Query Parameters - **type** (string) - Optional - Filter items by type (e.g., emote, mvp, nameplate, spray) - **page** (integer) - Optional - Page number for pagination - **limit** (integer) - Optional - Number of items per page ### Request Example ```bash curl --location --request GET 'https://marvelrivalsapi.com/api/v1/items?type&page&limit' \ --header 'x-api-key:' ``` ### Response #### Success Response (200) - **total_items** (integer) - Total count of items - **items** (array) - List of item objects #### Response Example ```json { "total_items": 100, "items": [ { "id": "30000001", "name": "Rivals", "quality": "BLUE", "type": "Nameplate", "applicable_hero": "0", "icon": "items/rivals-30000001-icon.webp", "slug": "rivals-30000001", "description": null } ] } ``` ``` -------------------------------- ### GET /api/v1/player/{query} Source: https://docs.marvelrivalsapi.com/player-stats-19312751e0 Retrieves player data for a specific player identified by uid or username. ```APIDOC ## GET /api/v1/player/{query} ### Description This endpoint retrieves player data for a specific player identified by `uid` or `username`. Searching by `uid` is recommended for stability. ### Method GET ### Endpoint /api/v1/player/{query} ### Parameters #### Path Parameters - **query** (string) - Required - The player's unique ID (uid) or username. ### Response #### Success Response (200) - **body** (object) - Successful response containing player data. ``` -------------------------------- ### Retrieve Game Versions via cURL Source: https://docs.marvelrivalsapi.com/list-game-versions-19312737e0 Use this cURL command to fetch a list of game versions from the API. Ensure the x-api-key header is populated with your valid API key. ```Shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/game-versions?page&limit¤t' \ --header 'x-api-key;' ``` -------------------------------- ### Get Player Data Source: https://docs.marvelrivalsapi.com/player-stats-19312751e0 Use this endpoint to retrieve player statistics and information. Requires an API key. ```cURL curl --location --request GET 'https://marvelrivalsapi.com/api/v1/player/?season' \ --header 'x-api-key;' ``` -------------------------------- ### List Heroes API Request Source: https://docs.marvelrivalsapi.com/list-heroes-19312739e0 Use this cURL command to retrieve a list of all available heroes. Ensure you include your API key in the 'x-api-key' header. ```curl curl --location --request GET 'https://marvelrivalsapi.com/api/v1/heroes' \ --header 'x-api-key;' ``` -------------------------------- ### Authenticate API Requests Source: https://docs.marvelrivalsapi.com/authentication-1287038m0 Include the API key in the x-api-key header for every request made to the API. ```bash curl -X GET "https://marvelrivalsapi.com/api/v1/maps" -H "x-api-key: 50aswrtfdhsfgjdfg12j321dxf2g1hjdfg2j12szxdf1h0sazdfh21bzsdfhszdf" ``` -------------------------------- ### Retrieve Balances via cURL Source: https://docs.marvelrivalsapi.com/list-balances-19312731e0 Use this cURL command to fetch patch balances from the API. Ensure the x-api-key header is populated with your valid API key. ```Shell curl --location --request GET 'https://marvelrivalsapi.com/api/v1/balances?page&limit' \ --header 'x-api-key;' ``` -------------------------------- ### Search Player API Response (JSON) Source: https://docs.marvelrivalsapi.com/search-player-19312750e0 Example JSON response when successfully searching for a player. It includes the player's name and unique identifier (UID). ```json { "name": "Player One", "uid": "123456" } ``` -------------------------------- ### GET /api/v1/heroes/hero/{query}/stats Source: https://docs.marvelrivalsapi.com/hero-stats-19312741e0 Retrieves detailed statistics for a specific hero based on their name or ID. ```APIDOC ## GET /api/v1/heroes/hero/{query}/stats ### Description This endpoint retrieves detailed statistics for a specific hero based on their name or ID. The stats are fetched from an external API, and the response includes processed hero stats for analysis and display. ### Method GET ### Endpoint /api/v1/heroes/hero/{query}/stats ### Parameters #### Path Parameters - **query** (string) - Required - The name or ID of the hero. ### Request Example ```bash curl --location --request GET 'https://marvelrivalsapi.com/api/v1/heroes/hero/{query}/stats' \ --header 'x-api-key: ' ``` ### Response #### Success Response (200) - **hero_id** (integer) - The unique identifier of the hero. - **hero_name** (string) - The name of the hero. - **hero_icon** (string) - URL path to the hero icon. - **matches** (integer) - Total matches played. - **wins** (integer) - Total matches won. - **k** (float) - Average kills. - **d** (float) - Average deaths. - **a** (float) - Average assists. - **play_time** (string) - Total play time duration. - **total_hero_damage** (float) - Total damage dealt by the hero. - **total_hero_heal** (float) - Total healing provided by the hero. - **total_damage_taken** (float) - Total damage taken by the hero. - **session_hit_rate** (float) - Average hit rate percentage. - **solo_kill** (float) - Average solo kills. #### Response Example { "hero_id": 1032, "hero_name": "squirrel girl", "hero_icon": "/heroes/transformations/squirrel-girl-headbig-0.webp", "matches": 1952, "wins": 829, "k": 14.922131147540984, "d": 5.543032786885246, "a": 5.136782786885246, "play_time": "266h 52m 18s", "total_hero_damage": 34114415.0734396, "total_hero_heal": 9.024993896484375, "total_damage_taken": 13013868.561632827, "session_hit_rate": 0.373334447668276, "solo_kill": 1.8790983606557377 } ``` -------------------------------- ### GET /api/v1/item/{query} Source: https://docs.marvelrivalsapi.com/search-item-19312746e0 This endpoint allows searching for a specific item either by its unique ID or its name. ```APIDOC ## GET /api/v1/item/{query} ### Description This endpoint allows searching for a specific item either by its unique ID or its name. ### Method GET ### Endpoint /api/v1/item/{query} ### Parameters #### Path Parameters - **query** (string) - Required - The unique ID or name of the item to search for. ### Request Example ``` curl --location --request GET 'https://marvelrivalsapi.com/api/v1/item/' \ --header 'x-api-key;' ``` ### Response #### Success Response (200) - **item** (object) - The item matching the search criteria. #### Response Example ```json { "item": { "id": "30000001", "name": "Rivals", "quality": "BLUE", "type": "Nameplate", "applicable_hero": "0", "icon": "items/rivals-30000001-icon.webp", "slug": "rivals-30000001", "description": null } } ``` ``` -------------------------------- ### GET /api/v2/player/{query} Source: https://docs.marvelrivalsapi.com/player-stats-v2-19465518e0 Retrieves detailed player statistics for a specific player using their UID or username. ```APIDOC ## GET /api/v2/player/{query} ### Description This endpoint retrieves player data for a specific player identified by `uid` or `username`. Searching by `uid` is recommended for higher stability. ### Method GET ### Endpoint /api/v2/player/{query} ### Parameters #### Path Parameters - **query** (string) - Required - The unique identifier (uid) or username of the player. ### Response #### Success Response (200) - **application/json** - Successful response with player data ``` -------------------------------- ### GET /api/v1/match/{match_uid} Source: https://docs.marvelrivalsapi.com/search-match-19312748e0 Retrieves detailed match information for a specific match identified by its unique ID. ```APIDOC ## GET /api/v1/match/{match_uid} ### Description This endpoint retrieves match data for a specific match identified by the `match_uid`. It processes the match details and player stats. ### Method GET ### Endpoint /api/v1/match/{match_uid} ### Parameters #### Path Parameters - **match_uid** (string) - Required - The unique identifier for the match. ### Request Example ``` curl --location --request GET 'https://marvelrivalsapi.com/api/v1/match/{match_uid}' \ --header 'x-api-key: ' ``` ### Response #### Success Response (200) - **match_details** (object) - Successful response with match details. #### Response Example { "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": { "property1": "string", "property2": "string" }, "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" } ] } ] } } ```