API reference

A tree of static JSON files behind a CDN at https://kb.play-ascend.com. Every data request carries a key in the x-api-key header. Keys are free in the console.

Endpoints

GET /api/index.json — List games
GET /api/{game}/entities.json — List entities
GET /api/{game}/entity/{file}.json — Retrieve an entity
GET /api/{game}/fields.json — List fields
GET /api/{game}/codenames.json — List codenames

Limits

Per key, per five minutes. Read live from the tiers the edge enforces.

Loading…

Errors

401	missing_key	No x-api-key header, or one that is not a key at all.
401	duplicate_key	More than one x-api-key header.
403	invalid_key	A well-formed key that is unknown or revoked. Both get the same answer.
403	tier_excluded	A Pro key on a game served to free keys only. Use your free key for it.
429	key_blocked	An operator blocked this key until a time. Retry-After says how long.
429	rate_limited	Over your tier's requests per five minutes. Retry-After: 300.
503	key_check_unavailable	The key check could not run. Retry shortly.

Provenance

official_gamefiles	The publisher's game files: cited by the source, read from an install, or written by the publisher's own data generator.
official_patch	Confirmed by a specific patch note.
official_ingame	Observable in game.
inferred	Not stated and confirmed: arithmetic on stated figures (computedFrom names them), or published citing nothing.
measured	Derived by us from replay files.
community	Adopted from a third party, attributed.
unconfirmed	The source flags the figure as an estimate.

Field registry per game →

MCP server: use game-kb from Claude, Cursor or Codex →