Search hero costume

GET

/api/v1/heroes/hero/{hero_query}/costume/{costume_query}

Heroes

Maintainer:Alastor

This endpoint retrieves detailed information about a specific costume for a hero, including the costume's name, rarity, description, appearance, and, if the user is premium, a link to a video associated with the costume.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://marvelrivalsapi.com/api/v1/heroes/hero//costume/' \
--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.",
    "video": "/premium/videos/1016001.mp4?expires=1739247126&signature=703f6668b37f5100e4b333a201d873412f84ea5c5bbff067b29813e5833dc5f8"
}

Request

Path Params

hero_query

string

required

The name or ID of the hero whose costume is being fetched.

Example:

ironman

costume_query

string

required

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

Example:

mark_1

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 detailed costume information

Body

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.

video

string

optional

The URL to a video associated with the costume (available if the user is premium).

Example:

/premium/videos/1016001.mp4?expires=1739247126&signature=703f6668b37f5100e4b333a201d873412f84ea5c5bbff067b29813e5833dc5f8

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

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

List costumes

List items