Game concepts
Achievements

Achievements

Achievements are objectives to be met during the season by all your characters. They grant you gold, items, and achievement points, which allow you to earn season badges.

Progress is tracked at the account level, so all your characters contribute together to unlock achievements.

Achievement points and the number of achievements required to complete a season may change. You can always check the current requirements using the server status endpoint (opens in a new tab).

Achievement Types

  • combat_kill – Defeat monsters
  • combat_drop – Obtain item drops from combat
  • combat_level – Reach certain combat levels
  • gathering – Gather resources
  • crafting – Craft items
  • recycling – Recycle equipment
  • task – Complete tasks
  • use – Use consumables
  • npc_buy – Buy items from NPCs
  • npc_sell – Sell items to NPCs

Multi-Objectives

Achievements can have multiple objectives that must all be completed to unlock the achievement. Each objective tracks progress independently.

For example, an achievement might require you to:

  1. Defeat 50 Wolves (combat_kill, target: wolf)
  2. Collect 20 Wolf Hides (combat_drop, target: wolf_hide)

Each objective has:

FieldDescription
typeThe achievement type (e.g., combat_kill, crafting).
targetThe specific target (e.g., monster code, item code). Can be null for general objectives.
totalThe total amount required to complete this objective.
progressYour current progress (only in account achievement responses).
JSON
"objectives": [
  {
    "type": "combat_kill",
    "target": "wolf",
    "progress": 30,
    "total": 50
  },
  {
    "type": "combat_drop",
    "target": "wolf_hide",
    "progress": 12,
    "total": 20
  }
]

The achievement is completed when all objectives reach their required total.

Rewards

When you complete an achievement, you earn achievement points and rewards. Rewards can include gold and/or items.

JSON
"rewards": {
  "gold": 5000,
  "items": [
    { "code": "tasks_coin", "quantity": 3 },
    { "code": "iron_sword", "quantity": 1 }
  ]
}
FieldDescription
goldGold reward amount.
itemsList of item rewards, each with a code and quantity. Can be null if there are no item rewards.

When an achievement is completed, the rewards are automatically sent to your pending items. You can then claim them with any character on your account using the claim action. This ensures no rewards are lost even if your inventory is full at the time of completion.

Account Achievements

You can use this GET request to view your account's list of achievements, including progress on each objective.

cURL
curl --location --request GET 'https://api.artifactsmmo.com/accounts/{account}/achievements' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
Javascript
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
 
var requestOptions = {
   method: 'GET',
   headers: myHeaders,
   redirect: 'follow'
}; 
 
fetch("https://api.artifactsmmo.com/accounts/{account}/achievements", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

View the API Reference (opens in a new tab)

You can also view the complete list of possible achievements using this endpoint (opens in a new tab).

Season Badges

Client

Each season, accumulating enough achievement points can earn you unique seasonal badges.

You can view the current badges and requirements using this GET request.

cURL
curl --request GET \
  --url https://api.artifactsmmo.com/badges \
  --header 'Accept: application/json'
Javascript
const url = 'https://api.artifactsmmo.com/badges';
const options = {method: 'GET', headers: {Accept: 'application/json'}};
 
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

View the API Reference (opens in a new tab)