List maps

GET

/api/v1/maps

Maps

Maintainer:Alastor

Retrieves all available maps with optional pagination to control the number of results per page.

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "total_maps": 50,
    "maps": [
        {
            "id": "map-001",
            "name": "Sky Arena",
            "type": "1v1",
            "description": "A floating island with dynamic obstacles.",
            "image": "maps/sky-arena.webp"
        }
    ]
}

Request

Query Params

page

integer

optional

The page number to fetch (defaults to 1).

Example:

limit

integer

optional

The number of maps 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 maps with optional pagination.

Body

total_maps

integer

optional

The total number of maps available.

Example:

maps

array [object {5}]

optional

The list of maps.

string

optional

The unique ID of the map.

Example:

map-001

name

string

optional

The name of the map.

Example:

Sky Arena

type

string

optional

The type of map (e.g., qp, comp, arcade).

Example:

1v1

description

string

optional

A brief description of the map.

Example:

A floating island with dynamic obstacles.

image

string

optional

The file path to the map's image.

Example:

maps/sky-arena.webp

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

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

Search item

Search map