/
6.2 getFreeRounds()

6.2 getFreeRounds()

Owned by Anej Hrobat
Last updated: Mar 01, 2023

Get free rounds for the $game. They are valid until $validTo. You can search by multiple games

public getFreeRounds( [ string $currency = string(0) "" ,string $freeround_id , string $games , string $validTo , string $validFrom = string(0) "" ] )

Parameters

  • string $currency = string(0) "" - Default = "EUR"
  • string $freeround_id string(0) - Value of the variable looks like 627a500001232103210. 
  • string $gameids required - Value of the variable looks like 787(id) or gs#gs-three-kings(title). 
  • string $validTo = string(0) "" - Default = + 1 week 
  • string $validFrom = string(0) "" - Default = ""
  • string $betlevel = string(0) "" - Default = "" - Possible values are: min, mid, max. It defines the cost of the bet during the freerounds

Required parameters: $validTo , $currency

Type of requests

  • If freeround_id is not set (Returns promotions)
Shows all freerounds that have been added for a specific game
Example: "gameids": "787", "validTo": "2023-03-30", "validFrom": "2020-02-24" → Lists all freeroundes added for the game: "787" and between the date "validFrom" and "validTo"
  • If freeround_id is set (Returns users for a specific promotion)
Shows all freeround that have been used for a specific freeround_id and in a specific game

The method return all freerounds that have been added for a specific game and filtered by the freeround_id parameter

Example: "freeround_id": "627a500001232103210", "gameids": "787",   "validTo": "2023-03-30", "validFrom": "2020-02-24" → Lists all freeroundes added for the game: "787", for specific round_id and between the date "validFrom" and "validTo"


Request

REST REQUEST
Array
    (
        [api_password] => xapitest
        [api_login] => xapitest
        [method] => getFreeRounds
		[freeround_id] => ""
        [gameids] => "787"
		[validFrom] => 2022-04-30
		[validTo] => 2022-11-30
		[betlevel] => "min"
		[currency] => EUR
    )


Response

REST RESPONSE

If freeround_id is not set: 

ON SUCCESS
{
	"error": 0,
	"response": [
		{
			"freeround_id": "5e79c76972028844521a8470",
			"title": "freeround 1",
			"players": [
				"981007",
				"1005203"
			],
			"games": [
				"10463",
				"10463"
			],
			"available": 4,
			"betLevel": "min",
			"validFrom": "2020-03-24 01:00:00",
			"validTo": "2020-03-31 01:59:59",
			"created": "2020-03-24 09:40:09",
			"received": 1
		},
	...
}

If freeround_id is set: 

ON SUCCESS
{
	"error": 0,
		"response": [
			{
				"freeround_id": "5e79c76972028844521a8470",
				"players": [
					"981007",
				],
				"games": [
					"10463"
				],
				"available": 4,
				"betLevel": "min",
				"validFrom": "2020-03-24 01:00:00",
				"validTo": "2020-03-31 01:59:59",
				"created": "2020-03-24 09:40:09",
				"used": 0,
				"activated" null,
				"activatedDate": null,
				"win":null
				"completed":null
			},
			{
				"freeround_id": "5e79c76972028844521a8470",
				"players": [
					"981007",
				],
				"games": [
					"10463"
				],
				"available": 4,
				"betLevel": "min",
				"validFrom": "2020-03-24 01:00:00",
				"validTo": "2020-03-31 01:59:59",
				"created": "2020-03-24 09:40:09",
				"used": 0,
				"activated" null,
				"activatedDate": null,
				"win":null
				"completed":null
			}
			...
		],
		"currency" : "EUR"
}
ON ERROR
{
	"error": 1,
	"message": "unknown command"
}


Source Code
public function getFreeRounds($freeroundId, $games, $validTo, $validFrom = '', $betLevel = ''){
	return $this->client->addFreeRounds($freeroundId, $games, $validTo, $validFrom, $betLevel);
}

Related content