Map

GET https://marvelrivalsapi.com/api/v2/map/:id

Retrieves a specific maps information.

Headers

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

Query Parameters

Name	Type	Required	Description
id*	integer	✔️	The id of the map

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v2/map/1311"
     -H "x-api-key: YOUR_API_KEY"

Node.js

const axios = require("axios");

try {
    const response = await axios.get("https://marvelrivalsapi.com/api/v2/map/1311", {
        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/v2/map/1311"
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/v2/map/1311"))
            .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

{
    "id": 1311,
    "name": "Arakko",
    "full_name": "Hellfire Gala: Arakko: Sister Island of Krakoa",
    "location": "Hellfire Gala",
    "description": "Escort the \"Avatar of Krakoa\" payload through two checkpoints and to the Great Ring",
    "game_mode": "Convoy",
    "is_competitve": true,
    "sub_map": {
        "id": 1248,
        "name": null,
        "thumbnail": null
    },
    "video": "https://youtu.be/_DCOXD7X7yA",
    "images": [
        "/rivals/maps/map_1311.png",
        "/rivals/maps/medium/map_1311.png",
        "/rivals/maps/large/map_1311.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
}

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