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

Path Params

Header Params

Responses

🟢200OK

application/json

Successful response with the list of costumes for the hero

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

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

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

Hero leaderboard

Search hero costume