Search item

GET

/api/v1/item/{query}

Items

Maintainer:Alastor

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://marvelrivalsapi.com/api/v1/item/' \
--header 'x-api-key;'

Response Example

200 - Example 1

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

Request

Path Params

query

string

required

The unique ID or name of the item to search for.

Example:

30000001

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

The item matching the search criteria.

Body

item

object

optional

The item matching the search.

string

optional

Example:

30000001

name

string

optional

Example:

Rivals

quality

string

optional

Example:

BLUE

type

string

optional

Example:

Nameplate

applicable_hero

string

optional

Example:

icon

string

optional

Example:

items/rivals-30000001-icon.webp

slug

string

optional

Example:

rivals-30000001

description

string

optional

Example:

null

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

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

List items

List maps