View Source

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

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

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

If freeround_id is not set:

{
	"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:

{
	"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"
}

{
	"error": 1,
	"message": "unknown command"
}

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