Achievement

GET https://marvelrivalsapi.com/api/v1/achievement/:query

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

Headers

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

Query Parameters

Name	Type	Required	Description
query*	string	✔️	The unique ID or name of the achievement to search for.

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/achievement/Sticking Around"
     -H "x-api-key: YOUR_API_KEY"

Node.js

const axios = require("axios");

try {
    const response = await axios.get("https://marvelrivalsapi.com/api/v1/achievement/Sticking Around", {
        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/achievement/Sticking Around"
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/achievement/Sticking Around"))
            .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

{
    "name": "Multiversal Veterans",
    "mission": "Raise the Proficiency of 2 heroes to Captain.",
    "points": "20",
    "category": "Galacta's Guide",
    "icon": "/achievements/Multiversal_Veterans.webp",
    "rarity": "N/A"
}

400

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

401

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

404

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

500

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

Response Field Descriptions

Field	Type	Description
name	String	Name of the achievement (e.g., "Multiversal Veterans").
mission	String	Mission associated with the achievement (e.g., "Raise the Proficiency of 2 heroes to Captain.").
points	String	Points awarded for the achievement (e.g., "20").
category	String	Category of the achievement (e.g., "Galacta's Guide").
icon	String	Path to the icon representing the achievement (e.g., "/achievements/Multiversal_Veterans.webp").
rarity	String	Rarity of the achievement (e.g., "N/A").