Pending Items

Pending items are items waiting to be claimed by your account. They are generated by various game systems — such as achievements and Grand Exchange buy orders — and stored until one of your characters claims them.

Any character on your account can claim a pending item, as long as they have enough inventory space.

Sources

Pending items can come from several sources:

achievement — Items rewards from completing achievements.
grand_exchange — Items purchased through buy orders on the Grand Exchange.

View your pending items

You can view all your unclaimed pending items using the following request:

Endpoint: GET /my/pending-items

curl --request GET \
--url https://api.artifactsmmo.com/my/pending-items \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN'

const url = 'https://api.artifactsmmo.com/my/pending-items';
const options = {
method: 'GET',
headers: {
  Accept: 'application/json',
  Authorization: 'Bearer YOUR_TOKEN'
}
};

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/my/pending-items"
headers = {
  "Accept": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}

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

View the API Reference

Each pending item contains the following information:

{
  "id": "abc123",
  "account": "your_account",
  "source": "achievement",
  "source_id": "kill_chickens_1",
  "description": "Achievement: Kill 100 Chickens",
  "gold": 500,
  "items": "iron_sword:1,copper_ore:10",
  "created_at": "2025-01-15T12:00:00.000Z",
  "claimed_at": null
}

Field	Description
`id`	Unique identifier for the pending item.
`source`	Origin of the item (`achievement`, `grand_exchange`, `event`).
`source_id`	Reference ID from the source (e.g., achievement code, order ID).
`description`	Human-readable description.
`gold`	Gold amount included in the reward.
`items`	Items in format `item_code:quantity`, separated by commas.
`claimed_at`	`null` if unclaimed, otherwise the claim timestamp.

Claim a pending item

To claim a pending item, use any character on your account with the following request:

Endpoint: POST /my/{name}/action/claim_item/{id}

curl --request POST \
--url https://api.artifactsmmo.com/my/{name}/action/claim_item/{id} \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json'

const url = 'https://api.artifactsmmo.com/my/{name}/action/claim_item/{id}';
const options = {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  Accept: 'application/json',
  Authorization: 'Bearer YOUR_TOKEN'
}
};

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/my/{name}/action/claim_item/{id}"
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}

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

View the API Reference