List items

GET

/api/v1/items

Items

Maintainer:Alastor

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.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://marvelrivalsapi.com/api/v1/items?type&page&limit' \
--header 'x-api-key;'

Response Example

200 - Example 1

{
    "total_items": 100,
    "items": [
        {
            "id": "30000001",
            "name": "Rivals",
            "quality": "BLUE",
            "type": "Nameplate",
            "applicable_hero": "0",
            "icon": "items/rivals-30000001-icon.webp",
            "slug": "rivals-30000001",
            "description": null
        }
    ]
}

Request

Query Params

type

enum<string>

optional

Filter items by type. Possible values are 'emote', 'mvp', 'nameplate', 'spray'.

Allowed values:

emotemvpnameplatespray

Example:

nameplate

page

integer

optional

The page number to fetch (defaults to 1).

Example:

limit

integer

optional

The number of items to return per page (defaults to 10).

Example:

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

A list of items with applied filters and pagination.

Body

total_items

integer

optional

The total number of items available that match the filter.

Example:

100

items

array [object {8}]

optional

The list of items matching the filter and pagination criteria.

string

optional

The unique ID of the item.

Example:

30000001

name

string

optional

The name of the item.

Example:

Rivals

quality

string

optional

The quality of the item (e.g., BLUE, RED).

Example:

BLUE

type

string

optional

The type of the item (e.g., emote, mvp, nameplate, spray).

Example:

Nameplate

applicable_hero

string

optional

The hero the item is applicable to (if applicable).

Example:

icon

string

optional

The file path to the item's icon image.

Example:

items/rivals-30000001-icon.webp

slug

string

optional

The unique slug of the item.

Example:

rivals-30000001

description

string

optional

A description of the item (if available).

Example:

null

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

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

Search hero costume

Search item