All Achievements

GET https://marvelrivalsapi.com/api/v1/achievements

This endpoint retrieves a list of achievements. You can filter achievements by category and apply pagination.

Headers

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

Query Parameters

Name	Type	Required	Description
query*	string	✔️	The name or ID of the hero to Filter achievements by category. ex: Galacta's Guide
page	integer	❌	The page number to fetch (defaults to 1).
limit	integer	❌	The number of achievements to return per page (defaults to 10).

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/achievements?page=1&limit=10"
     -H "x-api-key: YOUR_API_KEY"

Node.js

const axios = require("axios");

try {
    const response = await axios.get("https://marvelrivalsapi.com/api/v1/achievements?page=1&limit=10", {
        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/achievements?page=1&limit=10"
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/achievements?page=1&limit=10"))
            .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_achievements": 100,
  "achievements": [
    {
      "id": "30000001",
      "name": "Rivals",
      "category": "Combat",
      "points": 50,
      "icon": "achievements/rivals-30000001-icon.webp"
    }
  ]
}

400

{
  "error": true,
  "message": "Invalid query parameters or filters.",
  "status": 400
}

401

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

404

{
  "error": true,
  "message": "No achievements found matching the filter criteria",
  "status": 404
}

500

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

Response Field Descriptions

Field	Type	Description
total_achievements	Number	Total number of achievements available (e.g., 100).
achievements	Array	List of achievements.
achievements.id	String	Unique identifier for the achievement (e.g., "30000001").
achievements.name	String	Name of the achievement (e.g., "Rivals").
achievements.category	String	Category of the achievement (e.g., "Combat").
achievements.points	Number	Points awarded for the achievement (e.g., 50).
achievements.icon	String	Path to the icon representing the achievement (e.g., "achievements/rivals-30000001-icon.webp").