Battlepass

GET

/api/v1/battlepass

Battle Pass

Maintainer:Alastor

This endpoint retrieves the battlepass data for a given season, including season details and the list of items available for the selected season.

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

{
    "season": 1,
    "season_name": "Rivals Season 1",
    "items": [
        {
            "name": "All-Butcher",
            "image": "/battlepass/1/all-butcher.jpg",
            "cost": "Unlock To Claim",
            "isLuxury": true
        }
    ]
}

Request

Query Params

season

integer

optional

The season number to fetch the battlepass data for. Defaults to season 1 if not provided.

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

Successful response with battlepass data

Body

season

integer

optional

The season number for the battlepass.

Example:

season_name

string

optional

The name of the season.

Example:

Rivals Season 1

items

array [object {4}]

optional

List of items available in the battlepass for the selected season.

name

string

optional

The name of the item.

Example:

All-Butcher

image

string

optional

The image URL for the item.

Example:

/battlepass/1/all-butcher.jpg

cost

string

optional

The cost or unlock status of the item.

Example:

Unlock To Claim

isLuxury

boolean

optional

Whether the item is considered a luxury item.

Example:

true

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

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

List game versions

List Heroes