Item

GET https://marvelrivalsapi.com/api/v1/item/:query

This endpoint allows searching for a specific item either by its unique ID or its name.

Headers

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

Query Parameters

Name	Type	Required	Description
query*	string	✔️	The unique ID or name of the item to search for.

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/item/30000001"
     -H "x-api-key: YOUR_API_KEY"

Node.js

const axios = require("axios");

try {
    const response = await axios.get("https://marvelrivalsapi.com/api/v1/item/30000001", {
        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/item/30000001"
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/item/30000001"))
            .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": "30000001",
    "name": "Rivals",
    "quality": "BLUE",
    "type": "Nameplate",
    "associated_hero": "0",
    "slug": "rivals-30000001",
    "description": null,
    "icon": "/items/Nameplate/rivals-30000001-icon.webp"
}

400

{
  "error": true,
  "message": "Invalid query parameters.",
  "status": 400
}

401

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

404

{
  "error": true,
  "message": "No item found with the provided ID or name.",
  "status": 404
}

500

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

Response Field Descriptions

Field	Type	Description
id	String	Unique identifier for the item
name	String	Name of the item
quality	String	Quality of the item (e.g., "BLUE")
type	String	Type of the item (e.g., "Nameplate")
associated_hero	String	Hero associated with the item (if any)
slug	String	Slug (URL-friendly identifier) for the item
description	String	Description of the item (can be null)
icon	String	URL or path to the icon image