All Items

GET https://marvelrivalsapi.com/api/v1/items

This endpoint retrieves a list of items. You can filter the items by type (e.g., emote, mvp, nameplate, spray) and apply pagination to control the number of items returned.

Headers

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

Query Parameters

Name	Type	Required	Description
type	string	❌	Filter items by type. Possible values are emote, mvp, nameplate, spray.
page	integer	❌	The page number to fetch (defaults to 1).
limit	integer	❌	The number of items to return per page (defaults to 10).

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/items?page=1&limit=10"
     -H "x-api-key: YOUR_API_KEY"

Node.js

const axios = require("axios");

try {
    const response = await axios.get("https://marvelrivalsapi.com/api/v1/items?page=1&limit=10", {
        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/items?page=1&limit=10"
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/items?page=1&limit=10"))
            .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

{
    "total_items": 651,
    "items": [
        {
            "id": "30000001",
            "name": "Rivals",
            "quality": "BLUE",
            "type": "Nameplate",
            "icon": "/items/Nameplate/rivals-30000001-icon.webp",
            "slug": "rivals-30000001",
            "description": null,
            "associated_hero": "0"
        },
        {
            "id": "30000002",
            "name": "Progenitor",
            "quality": "BLUE",
            "type": "Nameplate",
            "icon": "/items/Nameplate/progenitor-30000002-icon.webp",
            "slug": "progenitor-30000002",
            "description": null,
            "associated_hero": "0"
        },
  ]
}

400

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

401

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

404

{
  "error": true,
  "message": "No items found matching the filter criteria",
  "status": 404
}

500

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

Response Field Descriptions

Field	Type	Description
total_items	Number	Total number of items in the collection
items	Array	Array of item objects
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")
icon	String	URL or path to the icon image
slug	String	Slug (URL-friendly identifier) for the item
description	String	Description of the item (can be null)
associated_hero	String	Hero associated with the item (if any)