Skip to content
Player sessions / Demo session
Player sessions

Demo session

POST

/v1/games/{id}/demo

Fun play: the game with no player of yours, no wallet and no session.

SignedSandboxProduction

Nothing is staked and no wallet callback follows.

Request body (optional)

FieldTypeRequiredDescription
localestringnoen, ru-RU… translated to what the provider serves.
lobby_urlstringnoWhere the game's "back to lobby" goes.
player_countrystringnoISO 3166-1 alpha-2.
player_ipstringnoThe player's own address; country rules apply to a demo as to a session.
player_devicestringnodesktop or mobile.
response 200
{ "launch_url": "https://provider…/demo?game=…" }

Possible errors

errorHTTPRetryWhen
NO_DEMO409noThe game has no fun-play mode.
GAME_UNAVAILABLE409noThe game is not in your window, whether or not it exists.
GAME_RESTRICTED_IN_COUNTRY409noThe game cannot be played in the player's country.

Every endpoint can also answer UNAUTHORIZED, ADDRESS_NOT_ALLOWED, RATE_LIMITED and UPSTREAM_UNAVAILABLE. See the Error reference.

has_demo on GET /v1/games says in advance which games will answer, so a game marked false needs no demo button.