Game Versions

GET https://marvelrivalsapi.com/api/v1/game-versions

Retrieves all available game versions with optional pagination and the option to filter for the current version, including corresponding patch notes for each version.

Headers

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

Query Parameters

Name	Type	Required	Description
page	integer	❌	The page number to fetch (defaults to 1).
limit	integer	❌	The number of versions to return per page (defaults to 10)

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/game-versions"
     -H "x-api-key: YOUR_API_KEY"

Node.js

const axios = require("axios");

try {
    const response = await axios.get("https://marvelrivalsapi.com/api/v1/game-versions", {
        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/game-versions"
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/game-versions"))
            .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_versions": 8,
    "versions": [
        {
            "version": 20250314,
            "release": "March 12th, 2025",
            "patchNotesUrl": "/api/v1/patch-note/20250314"
        },
        {
            "version": 20250307,
            "release": "March 6th, 2025",
            "patchNotesUrl": "/api/v1/patch-note/20250307"
        },
        {
            "version": 20250221,
            "release": "Feb 3, 2025",
            "patchNotesUrl": "/api/v1/patch-note/20250221"
        },
        {
            "version": 20250214,
            "release": "Feb 13, 2025",
            "patchNotesUrl": "/api/v1/patch-note/20250214"
        },
        {
            "version": 20250122,
            "release": "Jan 22, 2025",
            "patchNotesUrl": "/api/v1/patch-note/20250122"
        },
        {
            "version": 20250110,
            "release": "Jan 10, 2025",
            "patchNotesUrl": "/api/v1/patch-note/20250110"
        },
        {
            "version": 20241219,
            "release": "Dec 19, 2024",
            "patchNotesUrl": "/api/v1/patch-note/20241219"
        },
        {
            "version": 20241210,
            "release": "Dec 10, 2024",
            "patchNotesUrl": "/api/v1/patch-note/20241210"
        }
    ]
}

400

{
  "error": true,
  "message": "Invalid pagination parameters.",
  "status": 400
}

401

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

404

{
  "error": true,
  "message": "No Game versions found",
  "status": 404
}

500

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

Response Field Descriptions

Field	Type	Description
total_versions	Number	Total number of versions available (e.g., 8).
versions	Array	Array containing version objects with detailed information on each version update.
version	Number	The unique version identifier, typically based on the release date (e.g., 20250314).
release	String	The release date of the patch (e.g., "March 12th, 2025").
patchNotesUrl	String	URL or API endpoint to access the patch notes for the specific version (e.g., "/api/v1/patch-note/20250314").