Skip to main content
This endpoint generates a secure game launch URL for a specified player and game. Once you have the URL, you can open it in an iframe embedded in your site or redirect the player directly to it in a new tab. Each call produces a session-specific URL tied to the player, provider, and game you supply.

​
Request

POST /v1/game/launch

​
Headers

NameValue
AuthorizationBearer <API_TOKEN>
Content-Typeapplication/json
Acceptapplication/json

​
Request Body

​
playerId
string
required
Your unique identifier for the player on your system.
​
providerId
number
required
The unique identifier of the game provider. Retrieve valid provider IDs from List Providers.
​
gameId
number
required
The unique id of the game to launch. Retrieve valid game ids from List Games.
​
language
string
required
Language code for the game interface (e.g., en). The game UI will be rendered in this language where supported by the provider.
​
returnUrl
string
required
URL to redirect the player after they exit the game.
​
isStreamer
bool
required
If isStreamer is true, the player’s report is not considered to agent’s report, and the player can have more than 100% RTP.

​
Example Request

curl --request POST \
  --url https://api.igamingace.com/v1/game/launch \
  --header "Authorization: Bearer <API_TOKEN>" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
    "playerId": "playerId_onOperatorSide",
    "providerId": 1,
    "gameId": 655,
    "language": "en",
    "returnUrl": "https://yourcasino.com/lobby",
    "isStreamer": false
  }'

​
Response

​
Example Response

{
  "success": true,
  "message": "OK",
  "data": "https://games.igamingace.com/launch?token=123456..."
}

​
Response Fields

​
success
bool
Indicates whether the request was processed successfully.
​
message
string
Result message of the request (e.g., "OK").
​
data
string
Game Launch URL.