Public API

Warmane Armory API

Read cached character data or request a fresh snapshot. All responses are JSON, and no authentication is required.

GET /api/character/{name}/{realm}

Get character data

Returns the most recently cached snapshot, compact gear/talent stat contributions for each specialization, an achievement summary, and the character's best cached Uwu-logs overall rank with its specialization. This request does not contact Warmane. If no cached snapshot exists, it returns 404 Not Found.

Example

curl https://armory.raiding.site/api/character/Puredecay/Icecrown
GET /api/character/{name}/{realm}/stats

Get character stats

Returns primary stat totals, attack power, spell power, and combat ratings for every specialization. Each rating includes its raw value and converted percentage. Scoped talent hit bonuses are returned separately with lowercase keys.

Example

curl https://armory.raiding.site/api/character/Puredecay/Icecrown/stats
GET /api/character/{name}/{realm}/achievements

Get raid achievements

Returns cached Wrath raid progression grouped by raid and size. It does not contact Warmane; available is false until achievement data has been cached, and complete shows whether all supported categories are present.

Example

curl https://armory.raiding.site/api/character/Puredecay/Icecrown/achievements
POST /api/requestupdate/{name}/{realm}

Request an update

Queues a new character snapshot and returns 202 Accepted. Updates are limited to once every five minutes per character. Requests during that window return 429 Too Many Requests with a Retry-After header.

Example

curl -X POST https://armory.raiding.site/api/requestupdate/Puredecay/Icecrown

Response notes

  • updatedAt contains the snapshot time in ISO 8601 format.
  • Stat percentages are JSON numbers measured in percentage points; they do not include a % suffix.
  • Talent hit bonuses retain their scope, such as spells or melee and ranged attacks, so conditional bonuses are not presented as universal hit.
  • Final hit percentage is ratings.{type}_hit_rating.percent plus the applicable talentHitPercent.{scope} value.