List costumes

GET

/api/v1/heroes/hero/{query}/costumes

Heroes

Maintainer:Alastor

This endpoint retrieves the list of costumes available for a specific hero, based on their name or ID. The costume list includes details such as the costume's name, icon, rarity, description, and appearance. If the user has premium status, additional premium costumes may be included.

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

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

Request

Path Params

query

string

required

The name or ID of the hero to fetch costumes for.

Example:

ironman

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 costumes for the hero

Body

array of:

string

optional

The unique ID of the costume.

Example:

costume_001

name

string

optional

The name of the costume.

Example:

Ironman Mark 1

icon

string

optional

The URL to the costume's icon image.

Example:

/costumes/loki-1016001.png

rarity

string

optional

The rarity level of the costume.

Example:

Rare

description

string

optional

A brief description of the costume.

Example:

The original Ironman suit with a rough, industrial design.

appearance

string

optional

A description of the costume's appearance.

Example:

A shiny metallic suit with a red and gold color scheme.

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

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

Hero leaderboard

Search hero costume