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.

The example answer is beside it, from the catalogue as it is now.

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.

GEThttps://isleswiki.net/api/v1/items/{key}

curl "https://isleswiki.net/api/v1/items/model:isles:armor/melee/leviahide_helmet"

200OKapplication/json

{
  "version": "v3877",
  "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"
    ],
    "tooltipJson": [
      {
        "text": "",
        "extra": [
          {
            "text": "Leviahide Helmet",
            "color": "aqua",
            "italic": false
          }
        ],
        "color": "yellow",
        "italic": true
      },
      {
        "text": " ",
        "extra": [
          {
            "text": " ",
            "shadow_color": 0
          },
          {
            "text": "                ",
            "extra": [
              {
                "text": "Leviahide Helmet",
                "bold": true
              }
            ]
          }
        ],
        "color": "white",
        "italic": false
      },
      {
        "text": "              Rare Helmet",
        "color": "white",
        "italic": false
      },
      "… 29 more"
    ],
    "gear": {
      "slot": "Helmet",
      "slotGroup": "armor",
      "class": "melee",
      "level": 25,
      "craftedWith": null,
      "craftedAt": null,
      "set": "Leviahide",
      "damageType": null,
      "attackEnergy": null,
      "defaultAttack": null,
      "normalAttack": 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": []
    },
    "upgradeSteps": [],
    "recipe": null,
    "buffs": [],
    "elixir": null,
    "obtainedFrom": [],
    "usedIn": []
  }
}

Authorization#

Request#

Path parameters

Response#

Errors#

Authorization

Request

Response

Errors