The Bet Brothers
HomeNewsLinkedIn
  • The Bet Brothers APIS
    • ๐ŸงฉCore Concepts
    • ๐Ÿ”API Flow
  • OPERATOR API
    • ๐Ÿ”—Operator Integration Service
    • ๐Ÿ”‘Protocol API
      • Create api-token
      • Revoke api-token
  • ๐Ÿš€Game Launcher API
    • Get Game Providers
    • Get Games
    • Launch Game in Demo Mode
    • Launch game in Real Mode
  • ๐Ÿ’ฐWallet API
    • Balance
    • Bet
    • Win
    • Refund
    • Rollback Win
  • โšกFree Spin API
    • Add Free Spin
    • Cancel Free Spin
  • ๐ŸŽฎGame Insights
    • Get Game Bet Levels
    • Get Round Info
  • ๐Ÿ“–Addendum
    • TBB Error Codes
    • Wallet Error Response
  • SUPPLIER API
    • ๐Ÿ”—Supplier Integration Service
    • ๐Ÿ”‘Supplier Protocol API
    • ๐Ÿš€Game Launcher API
      • Launch Game in Demo Mode
      • Launch Game in Real Mode
  • ๐ŸŽฒGame Events
    • Balance
    • Bet
    • Win
    • Refund
  • ๐Ÿ“–Addendum
    • TBB Error Codes
Powered by GitBook
On this page
  1. Free Spin API

Add Free Spin

PreviousFree Spin APINextCancel Free Spin

Last updated 10 days ago

โšก
post

Adds a specified number of free spin rounds to an Integrated Platform player account. Please ensure that the selected game supports free spins.

Header parameters
AuthorizationstringRequired

Bearer token for authorization (e.g. Bearer YOUR_API_TOKEN)

Body
player_idstringRequired

Unique identifier of player.

referencestringRequired

Reference string.

roundsintegerRequired

Number of free spin rounds to be created.

amountintegerRequired

Specifies the bet amount for each free spin round, expressed in subunits. Acceptable values depend on predefined spin levels, which can be retrieved via the Free Spin Levels API.

currency_codestringRequired

Identifier of currency (ISO 4217).

start_datestring ยท date-timeRequired

The start date and time for the free spins validity, following the ISO 8601 format (YYYY-MM-DDTHH:MM:SS).

end_datestring ยท date-timeRequired

The end date and time for the free spins validity, following the ISO 8601 format (YYYY-MM-DDTHH:MM:SS).

bonus_codestringRequired

Campaign bonus ID/code.

Responses
200
Free spin rounds successfully granted.
application/json
503
Service Unvailable.
application/json
post
POST /api/freespin/create HTTP/1.1
Host: 
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 178

{
  "reference": "wazdan::426",
  "player_id": "12",
  "currency_code": "EUR",
  "rounds": 1,
  "amount": 100,
  "bonus_code": "1233",
  "start_date": "2023-06-26T14:30:00",
  "end_date": "2023-06-28T23:59:59"
}
{
  "status": "ok",
  "freespin_id": 54636
}