Facets

Facets are the API's enum dictionary. Every low-cardinality field (rarities, kinds, types, slots, and so on) is published as a stable list of { value, label } records, the same shape for every facet and every tier. Filter params like &rarity only accept values from their facet, so fetch /v2/facets once at boot and bind your dropdowns to it instead of hard-coding the members. The dictionary is rebuilt from the live tables on every refresh, so new values from future patches appear automatically.

Item and monster responses carry raw slugs only ("rarity": "rare"). The display label ("Rare") is shared by hundreds of rows, so the API leaves it out and lets render-time UIs look it up from the dictionary.

GET/v2/facets

The full dictionary. Returns every facet keyed by name under facets, each carrying its values plus a description and an auth_required flag.

Response shape: { facets: { <name>: { name, description, auth_required, values: [ { value, label } ] } } }.

GET/v2/facets/{name}

namepath
Pick a facet from the dictionary

One facet by name. Same record as above, returned under facet.

GET/v2/facets/{name}/{value}

namepath
Pick a facet from the dictionary
valuepath
A value within the chosen facet (type one from its values list)
Example
rare

A single value record, returned under value.

GET/v2/facets/ids/{type}

typepath
Pick an entity type

An id facet. Where an enum facet lists a handful of static values, an id facet lists every entity of one kind as { value, label }: the canonical id plus its display name. This is the lexicon that powers the id-picker dropdowns and prose auto-linking. Rows are sorted by label; entities whose name can't be resolved are omitted.

Rows also carry an icon_url (an absolute CDN url for the entity's icon) whenever the catalog stores one, so an embed can paint an inline icon straight from the CDN. Items add a meta rarity slug, and quests add their title-derived slug (the page URL, which the mechanical id can't reconstruct). Each is present only when it applies.

Supported {type} values: monster, class, merchant, spell, perk, skill, map, item, religion, emote, attribute, song, shape_shift, module, dungeon, quest, container, patch and leaderboard. An unknown type returns 404.