IslesWikiNot officially affiliated with Isles

API reference

What the API holds

The root of the API. catalogue.version changes with every edit on the wiki: poll this instead of the big lists to see whether anything changed.

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.

Response

200 OK: The catalogue's version and counts, and the routes.

200OKapplication/json
{
  "version": "v775",
  "data": {
    "name": "IslesWiki API",
    "docs": "https://isleswiki.net/docs",
    "catalogue": {
      "version": "v775",
      "builtAt": "2026-09-24T23:21:39.025Z",
      "items": 978,
      "sources": 134,
      "elixirs": 21,
      "skillTrees": 12,
      "buffs": 32,
      "augments": 44
    },
    "routes": [
      "https://isleswiki.net/api/v1/items",
      "https://isleswiki.net/api/v1/items/{key}",
      "…"
    ]
  }
}

Errors

  • 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.