Integration

Catalog and capabilities

Three public, read-only endpoints describe what is available. They need no partner or api_key.

Endpoint	Purpose
`GET /games/health`	Published games with every language the game offers and the `free_spins` / `target_outcomes` flags
`GET /capabilities`	The stable casino contract: games with provider, name, currencies, modes and the three casino languages
`GET /health`	Liveness probe
`GET /docs/openapi.json`	This API as an OpenAPI 3.1 document (see the API reference)

`GET /games/health`#

bash

curl -s https://notell-api.com/games/health

json

{
  "status": "ok",
  "games": [
    {
      "game_id": "gates-of-olympus",
      "languages": ["en", "ru", "uk"],
      "free_spins": true,
      "target_outcomes": true
    }
  ]
}

Field	Meaning
`games[].game_id`	The id to send as `symbol` in `/playGame.do` and `/gameActions.do`
`games[].languages`	Standard language codes the game accepts at launch (Languages)
`games[].free_spins`	Operator free spins are available for the game
`games[].target_outcomes`	Operator target outcomes are available for the game

The answer also contains diagnostic fields (release and build identifiers); do not depend on them.

Currently 445 of 446 games support free spins and 433 support target outcomes. The searchable table of all games is on the games list; it is generated from this endpoint.

`GET /capabilities`#

json

{
  "status": "ok",
  "mode": "TEST_ONLY",
  "currencies": [{"code": "UAH", "precision": 2}, {"code": "USD", "precision": 2}, {"code": "EUR", "precision": 2}, {"code": "RUB", "precision": 2}],
  "games": [
    {
      "gameId": "gates-of-olympus",
      "name": "Gates of Olympus",
      "provider": "pragmatic",
      "currencies": ["UAH", "USD", "EUR", "RUB"],
      "languages": ["ru", "en", "uk"],
      "defaultCurrency": "UAH",
      "defaultLanguage": "uk",
      "promoSupported": true,
      "modes": ["spin", "ante", "purchase", "promo"]
    }
  ]
}

Field	Meaning
`provider`	`endorphina`, `pragmatic` or `nolimitcity`
`languages`	Only the casino languages `ru`, `en`, `uk` — a fixed contract for casino front ends. Use `/games/health` for the full per-game list
`modes`	Informational names of the game's modes (for example `spin`, `ante`, `purchase`, `gamble`)
`promoSupported`	Kept for compatibility with the casino contract; for operator free spins use `free_spins` in `/games/health`

Some games additionally carry informational fields (for example configurableRtp). They are optional.

`GET /health`#

json

{"status": "ok", "mode": "TEST_ONLY"}

Answers HTTP 503 DATABASE_UNAVAILABLE when the platform cannot reach its storage. Use it for uptime monitoring only; do not call it per player action.

Using the catalog in your integration#

Build your lobby from /capabilities (names, providers) and enrich it with /games/health (languages, features). Cache the data for several minutes — it changes only when games are published.
Before offering free spins or target outcomes in your back office, check the flags; otherwise the API answers FREE_SPINS_UNSUPPORTED / FORCED_OUTCOMES_UNSUPPORTED.
Which optional modes a project may use (bonus buy, ante, gamble) is controlled in the admin panel, Projects → Providers.

Catalog and capabilities

GET /games/health#

GET /capabilities#

GET /health#

Using the catalog in your integration#

`GET /games/health`#

`GET /capabilities`#

`GET /health`#