Costume

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

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.

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.
costume_query*	string	✔️	The name or ID of the costume to fetch for the hero.

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/heroes/hero/squirrel girl/costume/Cheerful Dragoness"
     -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/costume/Cheerful Dragoness", {
        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/costume/Cheerful Dragoness"
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/costume/Cheerful Dragoness"))
            .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.",
  "video": "/premium/videos/1016001.mp4?expires=1739247126&signature=703f6668b37f5100e4b333a201d873412f84ea5c5bbff067b29813e5833dc5f8"
}

400

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

401

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

404

{
  "error": true,
  "message": "Hero or costume not found. The specified hero or costume was not found in the database",
  "status": 404
}

500

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

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...").
video	String	URL or path to the premium video associated with the costume. The link typically includes an expiration timestamp and a signature for access control (e.g., /premium/videos/1016001.mp4?expires=1739247126&signature=703f6668b37f5100e4b333a201d873412f84ea5c5bbff067b298