Marvel Rivals API

https://docs.marvelrivalsapi.com
Admin
Marvel Rivals API is a RESTful interface providing developers access to real-time game data...
Tokens:28,812
Snippets:166
Trust Score:4.9
Update:6 months ago
Show doc for...
Tokens:
Raw
### 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": "<p>Details in HTML format.</p>"
        }
    ]
}
```

--------------------------------

### 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&current' \
--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": "<h2>New Features</h2><p>Several new features have been added...</p>",
    "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&current' \
--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: <your_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: <your_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"
                    }
                ]
            }
        ]
    }
}
```
Tokens:
Raw