Reference

API reference

Base URL: https://notell-api.com. The index below lists every endpoint, /gameActions.do method and wallet callback; each entry links to the page that documents it with parameters, examples and errors.

The OpenAPI document is in English. Download openapi.json

Operator endpoints

Endpoint	Purpose
POST`/playGame.do`	Open a game for a player: returns the session link (real-wallet mode or free-play demo).
POST`/playerRtp.do`action`get`	Read a player's personal RTP state.
POST`/playerRtp.do`action`set`	Set a player's personal RTP (60–100 %).
POST`/playerRtp.do`action`auto`	Return a player to automatic RTP control.
POST`/playerRtp.do`action`bet-limit`	Set or remove a per-player bet limit.

Methods of POST /gameActions.do

Endpoint	Purpose
POST`/gameActions.do`method`freespins_create`	Grant free spins to a player in one game.
POST`/gameActions.do`method`freespins_get`	Read one free-spins grant by `grant_id` or `external_id`.
POST`/gameActions.do`method`freespins_list`	List grants of the project with filters (newest first, up to 200).
POST`/gameActions.do`method`freespins_cancel`	Cancel the unused spins of an active grant.
POST`/gameActions.do`method`outcome_schedule`	Schedule a target outcome: a win of a given multiple on a player's n-th paid spin.
POST`/gameActions.do`method`outcome_get`	Read one target outcome by `outcome_id` or `external_id`.
POST`/gameActions.do`method`outcome_list`	List target outcomes with filters (up to 200).
POST`/gameActions.do`method`outcome_cancel`	Cancel a target outcome that has not been applied yet.
POST`/gameActions.do`method`round_cancel`	Cancel an unfinished round and refund its debit.
POST`/gameActions.do`method`report_rounds`	Round history with bet, win and refund per round (paged).
POST`/gameActions.do`method`report_ggr`	GGR (bets − refunds − wins) per day, game and currency.
POST`/gameActions.do`method`report_reconciliation`	Wallet totals per player and currency to reconcile against your ledger.

Wallet callbacks (platform calls your server)

Endpoint	Purpose
CALLBACK`session_info`	Read the player's balance when a game is launched.
CALLBACK`bet`	Debit the stake before a paid round; refuse it with `INSUFFICIENT_FUNDS`.
CALLBACK`win`	Credit a win; for free spins one final credit per grant.
CALLBACK`refund`	Give back a debit (unconfirmed bet or operator cancel).
CALLBACK`round_info`	Notification that a round started or finished (bookkeeping only).
CALLBACK`freespins_finished`	Summary of a finished free-spins grant (after the final credit).

Public read-only endpoints

Endpoint	Purpose
GET`/games/catalog`	Game catalog: image, category, RTP, volatility, features, max win.
GET`/games/health`	Published games with launch languages and operator capabilities.
GET`/capabilities`	Casino capability list: currencies, games, callback IPs, rate limits.
GET`/health`	Liveness check (database reachable).