Raids

Raids are scheduled cooperative encounters where all players attack the same boss and reduce a shared HP pool. Each raid opens on specific UTC weekdays and remains active for a limited duration.

To participate, move a character to a map whose content type is raid while the raid is active, then use the normal fight action. You may fight with up to three of your own characters when they are on the same raid map.

Each fight contributes its damage to:

The raid’s shared remaining_hp.
Your account’s points on the raid leaderboard.

Unlike a regular fight, you win a raid fight by either surviving all 100 turns or finishing the boss.

The raid succeeds as soon as its shared HP reaches zero. It fails if the duration expires first.

Raid Status

Status	Description
`upcoming`	The raid is waiting for its next scheduled opening.
`active`	The raid is open and can be fought.
`finished_success`	Players reduced the shared HP to zero.
`finished_failure`	The raid duration expired before the shared HP reached zero.

The active_instance field contains the current shared HP and closing time while a raid is active. latest_instance contains the most recent active or finished instance.

Rewards

Raid rewards are distributed after the raid ends and are sent to your pending items.

Reward type	Description
`damage_rewards`	Grants items for each `damage_per_reward` points you earn, up to `max_rewards` when a cap is configured.
`leaderboard`	Grants items based on the final account leaderboard rank.

The leaderboard is account-based: damage dealt by all of your participating characters contributes to the same account score.

Retrieve Raids

Use GET /raids to list all raids and inspect their schedule, rewards, current status, shared HP, and next opening.

curl --request GET \
--url 'https://api.artifactsmmo.com/raids?page=1&size=50' \
--header 'Accept: application/json'

const url = 'https://api.artifactsmmo.com/raids?page=1&size=50';
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);
}

import requests

url = "https://api.artifactsmmo.com/raids"
headers = {"Accept": "application/json"}
params = {"page": 1, "size": 50}

response = requests.get(url, headers=headers, params=params)
print(response.json())

View the API Reference

Use GET /raids/{code} to retrieve one raid.

curl --request GET \
--url 'https://api.artifactsmmo.com/raids/god_of_the_sun' \
--header 'Accept: application/json'

const url = 'https://api.artifactsmmo.com/raids/god_of_the_sun';
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);
}

import requests

url = "https://api.artifactsmmo.com/raids/god_of_the_sun"
headers = {"Accept": "application/json"}

response = requests.get(url, headers=headers)
print(response.json())

View the API Reference

Important fields include:

Field	Description
`monster`	Monster code used by the raid encounter.
`schedule.weekdays`	UTC weekdays when the raid opens.
`schedule.start_hour_utc`	UTC hour when the raid opens.
`schedule.duration_hours`	Maximum duration of each raid instance.
`next_start_at`	Next scheduled opening in UTC.
`participant_count`	Number of accounts that contributed to the active or latest instance.
`active_instance.remaining_hp`	Remaining shared HP while the raid is active.

Raid Leaderboard

Use GET /raids/{code}/leaderboard to retrieve the leaderboard for the active raid instance, or the latest instance when no raid is active.

curl --request GET \
--url 'https://api.artifactsmmo.com/raids/god_of_the_sun/leaderboard?page=1&size=50' \
--header 'Accept: application/json'

const url = 'https://api.artifactsmmo.com/raids/god_of_the_sun/leaderboard?page=1&size=50';
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);
}

import requests

url = "https://api.artifactsmmo.com/raids/god_of_the_sun/leaderboard"
headers = {"Accept": "application/json"}
params = {"page": 1, "size": 50}

response = requests.get(url, headers=headers, params=params)
print(response.json())

View the API Reference

Each entry contains the account name, position, and accumulated damage points.