Skip to main content

Start game

Request

URI: /start?{parameters}

Example usage: https://{base_url}/start?{parameters}

The request is executed using the GET method.

This method is used to get a link to start the game.

Request parameters

NameTypeRequiredDescription
demobooleanNofalse: launch game in live mode
true: launch game in demo mode (in this case token and userId are not required)
tokenstringYesAuthorization code of user's session
Restrictions: 1..250
token is optional only if demo = true
userIdstringYesThe unique ID of the user
gameIdstringYesThe unique ID of the game
langstringNoLanguage code in ISO 639-1 format (e.g. en, ru, es)
exiturlstringNoFor games that support home URL (e.g. https://example.com)
mobilebooleanNoFor mobile devices
Accepted values: true, false
ipstringNoMandatory for providers that require IP address (Pariplay)
countrystringYesCountry code in ISO 3166-1 alpha-2 format (e.g AU, US) mandatory for providers that require country code (Pariplay, QT, ELBET)

Freespins Parameters

Accrual of freespins for a player would require inclusion of the parameters presented in the table.

note

The freespins parameters are required only if you want to provide free spins to the player.
These parameters are not required for a game start.

A request to the provider Get game bet values is needed for the freespin parameters to work with the following providers:

  • Pragmatic
  • Gameart
  • Platipus
  • Endorphina
  • Habanero
  • Ka gaming
  • OnlyPlay
  • Caleta gaming
  • Mascot gaming
  • Smartsoft
  • BoldPlay
  • Hacksaw Gaming
  • Relax Gaming
  • AmigoGaming
  • AGTsoftware
NameTypeRequiredDescription
bonusNamestringYesName of bonus (for bonus bets)
bonusRoundsintegerYesNumber of freespins(for bonus bets)
bonusBetfloatYesBet for one spin (for bonus bets)
bonusExpiredtimestampYesDate and time of bonus expiration (for bonus bets)

Example of an unsuccessful response

Response: /start?{parameters}
{
"status": false,
"errors": {
"error": "Description"
}
}