/v1/game/launch

Get a launch URL for a specific game to start playing

POST /v1/game/launch

This endpoint generates a secure game launch URL for the specified player and game. The URL can be used to open the game in an iframe or new tab.

Headers

Name	Value
Authorization	Bearer <API_TOKEN>
Content-Type	application/json
Accept	application/json

Request Body

{
  "playerExternalId": "playerId_onOperatorSide",
  "providerId": 1,
  "gameCode": "vswaysdogs",
  "language": "en",
  "currency": "USD",
  "returnUrl": "https://...",
  "rtp": 0
}

Key	Data Type	Description	Mandatory
playerExternalId	string	Unique player identifier on the operator’s system	Required
providerId	number	Unique identifier of the game provider	Required
gameCode	string	Unique code of the game to be launched	Required
language	string	Language code for the game interface (e.g., en)	Required
currency	string	Currency code used for gameplay (e.g., USD)	Required
returnUrl	string (URL)	URL to redirect the player after exiting the game	Optional
rtp	number	Requested RTP value for the game session (0 = Operator's Global RTP in account settings)	Required

Response

{
  "success": true,
  "message": "OK",
  "data": {
    "gameUrl": "https://..."
  }
}

Key	Data Type	Description
success	boolean	Indicates whether the request was processed successfully
message	string	Result message of the request
data	object	Game launch response data
data.gameUrl	string (URL)	URL used to launch and play the game session