GAP — Operator Freebet APIs

The Operator Freebet API allows operators to create and manage promotional free bets for users through GAP services.

It provides secure communication and enables operators to issue, cancel, and query free bets for specific games and players.

Stage base url: https://dev-api.dreamdelhi.com

---

Add Free Bet

Creates promotional free bets for one or multiple users.

Maximum 10 users per request and 10 free bets per user are allowed.

Endpoint

POST /api/operator/add-free-bet

Headers

Key	Value
Content-Type	application/json
Signature	RSA-SHA256 generated signature

Request Parameters

Parameter	Type	Enforce	Description
operatorId	string	Yes	Operator unique ID
user	array[string]	Yes	Max 10 users per request
currency	string	Yes	Currency (USD / INR / HKD etc)
freeBetAmount	float	Yes	Amount per bet
freeBetCount	int	Yes	Max 10 bets per user
gameId	string	Yes	GAP Game ID
gameCode	string	No	Game code
startDate	string (UTC)	Yes	Format: yyyy-MM-dd HH:mm:ss+00:00
endDate	string (UTC)	Yes	Expiry date
minWinMultiplier	float	No	>= 1.01 cashout multiplier
betType	string	Yes	Freebet / Bonus / Spin

Sample Request

{
    "operatorId": "op123",
    "user": ["user456", "user123"],
    "currency": "INR",
    "freeBetAmount": 25.5,
    "freeBetCount": 3,
    "gameId": "game789",
    "gameCode": "SLOTS_001",
    "startDate": "2019-07-15 00:49:42+00:00",
    "endDate": "2019-07-17 00:49:42+00:00",
    "minWinMultiplier": 1.25,
    "betType": "Freebet"
}

Response Parameters

Parameter	Type	Description
statusCode	string	API status
message	string	Response message
data	array	Created freebets

Data Object

Parameter	Type	Description
user	string	User ID
operatorFreebetId	string	Unique Freebet ID

Sample Response

{
    "statusCode": "RS_OK",
    "message": "Success",
    "data": [
        {
            "user": "user456",
            "operatorFreebetId": "op_fb_001"
        },
        {
            "user": "user123",
            "operatorFreebetId": "op_fb_002"
        }
    ]
}

Example cURL

curl --location 'https://dev-api.dreamdelhi.com/api/operator/add-free-bet' \
--header 'Content-Type: application/json' \
--header 'Signature: byMYoU1abC/86EVvEbwNtumfgZnlbGaAwbeJ3qu668RCZRnkFv8B3fCRAzM9rDnDdjommrhK0B3BVmbpdCv6UzyY1avfxE2lbihvrF/LMkY4oKOyL8IJuGBbSLgzpI+hKYzcb+qD/En9ZAH0V4gNXh6RqI/XIgfWhB55zF9pBs4=' \
--data '{
    "operatorId": "op123",
    "user": ["user456","user123"],
    "currency": "INR",
    "freeBetAmount": 25.50,
    "freeBetCount": 3,
    "gameId": "game789",
    "gameCode": "SLOTS_001",
    "startDate": "2019-07-15 00:49:42+00:00",
    "endDate": "2019-07-17 00:49:42+00:00",
    "minWinMultiplier": 1.25,
    "betType": "Freebet"
}'

---

Cancel Free Bet

Cancels an existing free bet using the operatorFreebetId. After cancellation, remaining free bets cannot be used.

Endpoint

POST /api/operator/cancel-free-bet

Request Parameters

Parameter	Type	Enforce	Description
operatorId	string	Yes	Operator ID
user	string	Yes	User ID
operatorFreebetId	string	Yes	Freebet ID to cancel

Sample Request

{
    "operatorId": "op123",
    "user": "user456",
    "operatorFreebetId": "op_fb_001"
}

Sample Response

{
    "statusCode": "RS_OK",
    "message": "Success"
}

Example cURL

curl --location 'https://dev-api.dreamdelhi.com/api/operator/cancel-free-bet' \
--header 'Content-Type: application/json' \
--header 'Signature: byMYoU1abC/86EVvEbwNtumfgZnlbGaAwbeJ3qu668RCZRnkFv8B3fCRAzM9rDnDdjommrhK0B3BVmbpdCv6UzyY1avfxE2lbihvrF/LMkY4oKOyL8IJuGBbSLgzpI+hKYzcb+qD/En9ZAH0V4gNXh6RqI/XIgfWhB55zF9pBs4=' \
--data '{
    "operatorId": "op123",
    "user": "user456",
    "operatorFreebetId": "op_fb_001"
}'

---

Get Freebet Info

Retrieves information about an existing freebet.

Endpoint

POST /api/operator/get-free-betinfo

Request Parameters

Parameter	Type	Enforce	Description
operatorId	string	Yes	Operator ID
user	string	Yes	User ID
operatorFreebetId	string	Yes	Freebet ID to query

Sample Request

{
    "operatorId": "op123",
    "user": "user456",
    "operatorFreebetId": "op_fb_001"
}

Example cURL

curl --location 'https://dev-api.dreamdelhi.com/api/operator/get-free-betinfo' \
--header 'Content-Type: application/json' \
--header 'Signature: byMYoU1abC/86EVvEbwNtumfgZnlbGaAwbeJ3qu668RCZRnkFv8B3fCRAzM9rDnDdjommrhK0B3BVmbpdCv6UzyY1avfxE2lbihvrF/LMkY4oKOyL8IJuGBbSLgzpI+hKYzcb+qD/En9ZAH0V4gNXh6RqI/XIgfWhB55zF9pBs4=' \
--data '{
    "operatorId": "op123",
    "user": "user456",
    "operatorFreebetId": "op_fb_001"
}'