List Heroes

GET

/api/v1/heroes

Heroes

Maintainer:Alastor

Retrieves a list of all available heroes with their details.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://marvelrivalsapi.com/api/v1/heroes' \
--header 'x-api-key;'

Response Example

200 - Example 1

{
    "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"
        }
    ]
}

Request

Header Params

x-api-key

string

required

The API key for authorization. It is necessary to provide a valid API key to access the data.

Example:

your-api-key-here

Responses

🟢200OK

application/json

Successful response with the list of heroes

Body

status

string

optional

Example:

success

heroes

array [object {6}]

optional

string

optional

Example:

hero_001

name

string

optional

Example:

Iron Man

alias

string

optional

Example:

Tony Stark

role

string

optional

Example:

DPS

abilities

array [object {3}]

optional

imageUrl

string <uri>

optional

Example:

/heroes/cards/ironman.png

🟠401Unauthorized

🔴500Server Error

Modified at 2025-07-23 14:35:31

Battlepass

Search hero