IslesWikiNot officially affiliated with Isles

API reference

Get an item

One item, the same shape as in the list. A key an item had before it moved (items that wear one model got a key each) answers with the item under the key it has now.

Authorization

AuthorizationOptional

Works without a key. Send one to use its own limit: Authorization: Bearer iwk_… or X-API-Key: iwk_…. See Authentication.

Counted: 60 calls a minute per address without a key.

Request

Path parameters

keystringRequired
The item's key, from a list or /search. Keys hold colons and slashes: send them as they are, or URL-encoded.

Response

200 OK: The item. Fields: data.

200OKapplication/json
{
  "version": "v775",
  "data": {
    "key": "model:isles:armor/melee/leviahide_helmet",
    "name": "Leviahide Helmet",
    "url": "https://isleswiki.net/item/model%3Aisles%3Aarmor%2Fmelee%2Fleviahide_helmet",
    "icon": "https://isleswiki.net/api/v1/icons/armor/melee/leviahide_helmet.png",
    "category": "armor/melee",
    "group": "armor",
    "rarity": "Rare",
    "type": "Helmet",
    "confirmed": true,
    "description": null,
    "merchantPrice": null,
    "lore": [
      "Rare Helmet",
      "",
      "+42.0-63.0 +42.0-63.0",
      "… 21 more"
    ],
    "gear": {
      "slot": "Helmet",
      "slotGroup": "armor",
      "class": "melee",
      "level": 25,
      "craftedWith": "Smithing",
      "craftedAt": 20,
      "set": "Leviahide",
      "damageType": null,
      "attackEnergy": null,
      "augmentSlots": 2,
      "stats": [
        {
          "stat": "Blunt Defense",
          "percent": false,
          "min": 42,
          "max": 63
        },
        {
          "stat": "Slash Defense",
          "percent": false,
          "min": 42,
          "max": 63
        },
        {
          "stat": "Base Defense",
          "percent": false,
          "min": 84,
          "max": 126
        },
        "… 4 more"
      ],
      "abilities": []
    },
    "recipe": {
      "skill": "Smithing",
      "level": 20,
      "ingredients": [
        {
          "name": "Gilled Hide",
          "item": "material_gilled_hide",
          "qty": 8
        },
        {
          "name": "Elastic Hide",
          "item": "minecraft:emerald|Elastic Hide",
          "qty": 3
        },
        {
          "name": "Fungal Spider Silk",
          "item": "minecraft:emerald|Fungal Spider Silk",
          "qty": 8
        },
        "… 1 more"
      ],
      "makes": null,
      "exp": 1200
    },
    "buffs": [],
    "elixir": null,
    "obtainedFrom": [],
    "usedIn": []
  }
}

Errors

  • 404not_foundNo item has that key.
  • 401bad_keyAn API key was sent that is unknown or revoked. Leave it out to use the free limit.
  • 429rate_limitedMore calls in a minute than the limit (60 per address without a key, or the key's own). Wait for Retry-After seconds.
  • 503unavailableThe catalogue could not be loaded. Rare; try again in a minute.