7.2 getFeatureBuy()

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

public getFeatureBuy( [ string $currency = string(0) "" ,string $featurebuy_id , string $games , string $validTo , string $validFrom = string(0) "" ] )

Parameters

string $currency = string(0) "" - Default = "EUR"
string $featurebuy_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 featurebuy_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 featurebuys that have been added for a specific game and filtered by the freeround_id parameter

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

Request

REST REQUEST

Array
    (
        [api_password] => xapitest
        [api_login] => xapitest
        [method] => getFeatureBuy
		[featurebuy_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": [
		{
			"featurebuy_id": "64074db4163b0000e600515b",
			"players": [
				"1007497"
			],
			"games": [
				"qs#qs-artemis-vs-medusa",
				"qs#qs-artemis-vs-medusa-mobile"
			],
			"betLevel": "min",
			"validFrom": "2016-05-01 02:00:00",
			"validTo": "2023-04-30 01:59:59",
			"created": "2023-03-07 15:44:04",
			"received": 0
		},
		{
			"featurebuy_id": "64075295163b0000e6005173",
			"players": [
				"1007497"
			],
			"games": [
				"qs#qs-artemis-vs-medusa",
				"qs#qs-artemis-vs-medusa-mobile"
			],
			"betLevel": "min",
			"validFrom": "2016-05-01 02:00:00",
			"validTo": "2023-04-30 01:59:59",
			"created": "2023-03-07 16:04:53",
			"received": 0
		}
	],
	"currency": "EUR"
}

If freeround_id is set:

ON SUCCESS

{
	"error": 0,
	"response": [
		{
			"featurebuy_id": "64074db4163b0000e600515b",
			"player": "1007497",
			"games": [
				"qs#qs-artemis-vs-medusa",
				"qs#qs-artemis-vs-medusa-mobile"
			],
			"betLevel": "min",
			"validFrom": "2016-05-01 02:00:00",
			"validTo": "2023-04-30 01:59:59",
			"created": "2023-03-07 15:44:04",
			"used": 0,
			"activated": null,
			"activatedDate": null,
			"win": null,
			"completed": false
		}
	],
	"currency": "EUR"
}

ON ERROR

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

Source Code

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