All Heroes

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

Retrieves a list of all available heroes with their details.

Headers

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

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/heroes"
     -H "x-api-key: YOUR_API_KEY"

Node.js

const axios = require("axios");

try {
    const response = await axios.get("https://marvelrivalsapi.com/api/v1/heroes", {
        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/heroes"
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/heroes"))
            .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": "1011",
        "name": "hulk",
        "real_name": "Bruce Banner",
        "imageUrl": "/rivals/heroes/card/hulk.png",
        "role": "Vanguard",
        "attack_type": "Melee Heroes",
        "team": [
            "Avengers"
        ],
        "difficulty": "4",
        "bio": "Brilliant scientist Dr. Bruce Banner has finally found a way to coexist with his monstrous alter ego, the Hulk. By accumulating gamma energy over transformations, he can become a wise and strong Hero Hulk or a fierce and destructive Monster Hulk – a true force of fury on the battlefield!",
        "lore": "Caught in the detonation of a powerful weapon of his own invention, Dr. Bruce Banner absorbed gamma radiation that transforms him into a massive green monster whenever his emotions rage out of control. As Banner, he's still a genius. But as the Hulk, he's the strongest one there is!\nBanner developed a special Gamma Belt to control his transformations and temper the Hulk's fury. But when the Timestream Entanglement transformed Los Diablos Missile Base into a demonic battleground, he realized that the best way to fight monsters was to let out the one within.",
        "transformations": [
            {
                "id": "0",
                "name": "Bruce Banner",
                "icon": "/heroes/transformations/bruce-banner-headbig-0.webp",
                "health": "200",
                "movement_speed": "6m/s"
            },
            {
                "id": "1",
                "name": "Hero Hulk",
                "icon": "/heroes/transformations/bruce-banner-headbig-1.webp",
                "health": null,
                "movement_speed": null
            },
        ],
        "costumes": [
            {
                "id": "1011001",
                "name": "Bruce Banner",
                "icon": "/costumes/bruce-banner-1011001.png",
                "quality": "NO_QUALITY",
                "description": "No description available",
                "appearance": "No appearance data available"
            },
        ],
        "abilities": [
            {
                "id": 101131,
                "icon": "/abilities/101131.webp",
                "name": "Puny Banner",
                "type": "Ultimate",
                "isCollab": false,
                "description": "Transform from Bruce Banner into Hero Hulk.",
                "additional_fields": {
                    "Key": "Q",
                    "Casting": "Transformation",
                    "Energy Cost": "600",
                    "Special Effect": "The caster is immobilized during the transformation process and gains Invincibility"
                },
                "transformation_id": "0"
            },
        ]
    },
]

401

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

500

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

Response Field Descriptions

Field	Type	Description
id	String	Unique hero ID.
name	String	Hero's display name.
real_name	String	The hero’s real-world identity.
imageUrl	String	URL or path to the hero's image.
role	String	The hero’s role (e.g., Vanguard, Support).
attack_type	String	Hero’s attack type (e.g., Melee Heroes).
team	Array<String>	Factions or affiliations the hero belongs to (e.g., Avengers).
difficulty	String	Difficulty rating of the hero (e.g., "4").
bio	String	Short biography of the hero.
lore	String	Extended lore/backstory of the hero.
transformations	Array<Object>	Different forms the hero can transform into.
transformations[].id	String	ID of the transformation.
transformations[].name	String	Name of the transformation (e.g., Bruce Banner).
transformations[].icon	String	Image path for the transformation.
transformations[].health	String | null	Health for the transformation (if available).
transformations[].movement_speed	String | null	Movement speed in meters per second (e.g., "6m/s").
costumes	Array<Object>	List of hero costumes/skins.
costumes[].id	String	ID of the costume.
costumes[].name	String	Name of the costume.
costumes[].icon	String	Icon path for the costume.
costumes[].quality	String	Quality level (e.g., NO_QUALITY).
costumes[].description	String	Description of the costume.
costumes[].appearance	String	Visual details about the costume appearance.
abilities	Array<Object>	List of the hero’s abilities.
abilities[].id	Number	Unique ability ID.
abilities[].icon	String	Icon path for the ability.
abilities[].name	String	Name of the ability.
abilities[].type	String	Type of the ability (e.g., Ultimate, Passive).
abilities[].isCollab	Boolean	Whether the ability is from a collaboration.
abilities[].description	String	Description of what the ability does.
abilities[].transformation_id	String	ID of the transformation this ability is tied to.
abilities[].additional_fields	Object	Dynamic key-value object with extra metadata. Keys vary per ability and may include: Key, Casting, Cooldown, Energy Cost, Special Effect, etc.