Sportsbook Start Game Request

Sportsbook Start Game Request

Requests a Sportsbook game launch URL and starts a new game.

Request endpoint: https://{groove_domain}/game/sportsbook/

Request Method: GET

{
  "url": "a URL for a javascript code that renders the sports book",
  "brandId": "brand identifier on BetBy side as configured on Groove",
  "key": "provider session ID. Built by the sessionId received from the casino with casino_id prefix",
  "themeName": "Design pattern identifier"
}

Request parameters:

Parameter Data type Description
accountid String(60) -[0-9a-zA-Z] required Account ID Example: 5179068
country String required Examples:
• IL
• UK
• US
currency String required Currency
Example: EUR
device_type String required The device currently used by the player.
Note: Some games are not available on both desktop and mobile devices.
Valid values:
• desktop
• mobile
exitUrl String optional Exit URL
Example: http://myhomepage.com
gameid Integer required Groove game ID.
Example: 80102
historyUrl String required The URL for viewing the player’s gaming history in the casino.
This is used for regulation requirements.
homeurl String required The page URL that the player is redirected to after closing the game.
Example: http://www.somecasinostaging.com/
is_test_account Boolean required when using real mode Indicates that the player is a test player using a test account.
Test players are excluded from reports.
Valid values:
•false: The player is a regular player with a real account.
•true: The player is used for testing purposes and uses a test
lang String required Language
Example: en_US
license String required The country that has gaming jurisdiction over the player.
Examples:
• Curacao
• Malta
• UK
mode String required The game mode. Valid values:
• demo
• real
operatorid String required The Groove ID for the casino.
Example: 11
rc_url String optional Rc_url
Example: https://realitycheckapp.groovegaming.com/
realityCheckElapsed Integer optional realityCheckElapsed
Example: 10
realityCheckInterval Integer optional realityCheckInterval
Example: 15
sessionid String(27) required Session ID
Example: ${ nogsoperatorid}_99d71938-c2d9-4844-b950-d598c2es

Example Response:

Success response:

{
  "url": "https://url_from_groove_response.com",
  "brandId": "11",
  "key": "11_4f5g-aa89-b81c-294a",
  "themeName": "Theme name",
  "token": "11_11_4f5g-aa89-b81c-294a"
}

Error response:

{
  "errMsg": "general_error"
}