All Maps

GET https://marvelrivalsapi.com/api/v1/maps

Retrieves all available maps with optional pagination to control the number of results per page.

Headers

Name	Value
Content-Type	application/json
x-api-key*	YOUR API KEY

Query Parameters

Name	Type	Required	Description
page	integer	❌	The page number to fetch (defaults to 1).
limit	integer	❌	The number of maps to return per page (defaults to 10).

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/maps?page=1&limit=10"
     -H "x-api-key: YOUR_API_KEY"

Node.js

const axios = require("axios");

try {
    const response = await axios.get("https://marvelrivalsapi.com/api/v1/maps?page=1&limit=10", {
        headers: {
            "x-api-key": "YOUR_API_KEY"
        }
    });
    console.log(response.data);
} catch (error) {
    console.error("Error fetching balances:", error.response ? error.response.data : error.message);
}

Python

import requests

url = "https://marvelrivalsapi.com/api/v1/maps?page=1&limit=10"
headers = {
    "x-api-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error {response.status_code}: {response.text}")

Java

import java.net.http.*;
import java.net.URI;
import java.io.IOException;

public class ApiClient {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://marvelrivalsapi.com/api/v1/maps?page=1&limit=10"))
            .header("x-api-key", "YOUR_API_KEY")
            .GET()
            .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
            System.out.println(response.body());
        } catch (IOException | InterruptedException e) {
            e.printStackTrace();
        }
    }
}

Response

200

{
    "total_maps": 34,
    "maps": [
        {
            "id": 1032,
            "name": "Yggdrasill Path",
            "full_name": "Yggdrasill Path - Yggsgard",
            "location": "Yggsgard",
            "description": "Beneath the sky-shutting canopy of the World Tree, Yggdrasill, lies the golden glory of Asgard, realm of the gods, now overgrown with the roots and flora. However, the throne-seizing scheme of Loki, god of mischief, threatens the ever-lasting prosperity of this kingdom and all of the Ten Realms.",
            "game_mode": "Convoy",
            "is_competitve": false,
            "sub_map": {
                "id": 1003,
                "name": null,
                "thumbnail": null
            },
            "video": "https://youtu.be/8nYwiVjhBWQ",
            "images": [
                "/rivals/maps/map_1032.png",
                "/rivals/maps/medium/map_1032.png",
                "/rivals/maps/large/map_1032.png"
            ]
        },
        {
            "id": 1034,
            "name": "Shin-Shibuya",
            "full_name": "Shin-Shibuya - Tokyo 2099",
            "location": "Tokyo 2099",
            "description": "Another world has emerged from the Timestream Entanglement! It's time to have some ramen and sushi after that nature walk! I'm thrilled that these foods still retain their classic flavors even in Tokyo of 2099! But it is a pity that there aren't any Kaiju or giant robots fighting in the city anymore...",
            "game_mode": "Convergence",
            "is_competitve": false,
            "sub_map": {
                "id": 1021,
                "name": null,
                "thumbnail": null
            },
            "video": "https://youtu.be/8NUtV1CkyKs",
            "images": [
                "/rivals/maps/map_1034.png",
                "/rivals/maps/medium/map_1034.png",
                "/rivals/maps/large/map_1034.png"
            ]
        },
  ]
}

400

{
  "error": true,
  "message": "Invalid query parameters or filters.",
  "status": 400
}

401

{
  "error": true,
  "message": "Invalid or missing API key.",
  "status": 401
}

404

{
  "error": true,
  "message": "No maps found.",
  "status": 404
}

500

{
  "error": true,
  "message": "An error occurred while fetching data.",
  "status": 500
}

Response Field Descriptions

Field	Type	Description
total_maps	Number	Total number of maps
maps	Array	An array of map objects with details

Breakdown of Map Object:

Field	Type	Description
id	Number	Unique identifier for the map
name	String	Short name of the map
full_name	String	Full name of the map, including location
location	String	Location of the map
description	String	Description of the map
game_mode	String	The game mode of the map (e.g., "Convoy", "Convergence")
is_competitve	Boolean	Whether the map is competitive or not
sub_map	Object	Sub-map details, includes id, name, and thumbnail
video	String	Video URL related to the map
images	Array	Array of image paths related to the map