All Costumes

GET https://marvelrivalsapi.com/api/v1/heroes/hero/:query/costumes

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.

Headers

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

Query Parameters

Name	Type	Required	Description
query*	string	✔️	The name or ID of the hero to retrieve.

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/heroes/hero/squirrel girl/costumes"
     -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/hero/squirrel girl/costumes", {
        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/hero/squirrel girl/costumes"
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/hero/squirrel girl/costumes"))
            .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": "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."
  }
]

400

{
  "error": true,
  "message": "Invalid hero name or ID. The provided name or ID does not match any known hero.",
  "status": 400
}

401

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

404

{
  "error": true,
  "message": "Hero not found. No hero data was found for the given name or ID",
  "status": 404
}

500

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

Response Field Descriptions

Field	Type	Description
id	String	Unique costume ID (e.g., "costume_001").
name	String	Name of the costume (e.g., "Ironman Mark 1").
icon	String	URL or path to the costume's icon image (e.g., /costumes/loki-1016001.png).
rarity	String	The rarity level of the costume (e.g., "Rare").
description	String	Short description of the costume (e.g., "The original Ironman suit...").
appearance	String	Detailed visual description of the costume (e.g., "A shiny metallic suit...").