Skip to main content
Free spins are bonus rounds where players spin the reels without wagering their own balance. During free spin rounds, GitSlotPark deducts spins from the free spin pool rather than from the player’s wallet. You use two platform API calls to manage free spins: /assignFreeSpin to grant a bonus and /freeSpinStatus to check progress.
During free spin rounds, GitSlotPark calls your /Withdraw callback with a freeSpin: true flag in the request body. Use this flag to distinguish free spin transactions from regular wallet debits so you can track and report them separately.

​
Assign free spins

Call POST /assignFreeSpin to grant a free spin bonus to a specific player on a specific game. You specify how many spins to assign, and GitSlotPark returns a freeSpinID you can use to track this bonus. Sign formula: agentID + userID + gameID + spinCount 
{
  "apiToken": "your-api-token",
  "agentID": "Partner01",
  "userID": "player_456",
  "gameID": "game_001",
  "spinCount": 15,
  "sign": "<hmac-sha256>"
}
Store the freeSpinID in your system so you can check the status of this bonus later.

​
Check free spin status

Call POST /freeSpinStatus to retrieve the current state of a free spin bonus, including how many spins have been used and how many remain. Sign formula: agentID + freeSpinID 
{
  "apiToken": "your-api-token",
  "agentID": "Partner01",
  "freeSpinID": "fs_abc123",
  "sign": "<hmac-sha256>"
}

​
Status values

The status field in the /freeSpinStatus response indicates the lifecycle stage of the bonus:
StatusMeaning
activeThe bonus is available and the player still has spins remaining
completedAll assigned spins have been used
expiredThe bonus period ended before all spins were used

​
Free spin transactions in your callback service

When a player uses a free spin, GitSlotPark calls your /Withdraw callback as it would for a regular bet, but includes freeSpin: true in the request body. This signals that the debit should come from the free spin allocation, not the player’s real-money balance. Handle this flag in your callback to:
  • Skip real-money balance checks for free spin rounds
  • Record the transaction under a separate free spin ledger entry
  • Keep your reporting accurate by distinguishing promotional play from real-money play

Assign free spin API

Full request and response schema for the /assignFreeSpin endpoint.

Free spin status API

Full request and response schema for the /freeSpinStatus endpoint.