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.
{
"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
- 401
bad_keyAn API key was sent that is unknown or revoked. Leave it out to use the free limit. - 429
rate_limitedMore calls in a minute than the limit (60 per address without a key, or the key's own). Wait for Retry-After seconds. - 503
unavailableThe catalogue could not be loaded. Rare; try again in a minute.