Skip to main content

List the games this casino may use

GET 
/games

Returns the catalog filtered to this casino's allowlist, nested: each entry is a game with its playable modes (bonus features). A mode's id is what a caller sends back as game_id on POST /battles — a game is never battled directly. A game with no allowed modes is not listed at all.

An empty allowlist returns an empty list — it does not mean "all games". A newly created casino with nothing allowed sees {"games": []} and every battle creation fails with game_not_allowed, which reads like a broken integration and is a configuration state. The allowlist is checked per MODE: allowing one mode of a multi-mode game shows that game with only that mode, not the whole game.

Allowlist changes are cached for up to 30 seconds, shared across every process of the instance. A change made in the admin console drops that cache on save, so it is normally visible at once.

Scope: games:read

Responses​

The allowed catalog, nested by game with its modes