# Add Free Spin

This endpoint enables The Bet Brothers platform to create an award for a player on the supplier's side.

## POST /supplier\_api/freespin/create

> Creates the specified number of free spin rounds for the player's account.\
>

OpenAPI:

```json
{"openapi":"3.0.0","info":{"title":"Casino API","version":"1.0.0"},"paths":{"/supplier_api/freespin/create":{"post":{"description":"Creates the specified number of free spin rounds for the player's account.\n","tags":["FreeSpins"],"parameters":[{"name":"X-REQUEST-SIGN","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA256 signature of the request body, generated using the shared secret.\n"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["provider_name","provider_id","player_id","game_symbol","rounds","currency_code","amount","start_date","end_date","bonus_code","brand_id"],"properties":{"provider_name":{"type":"string","description":"Name of the supplier."},"provider_id":{"type":"integer","description":"Unique identifier of the supplier."},"player_id":{"type":"string","description":"Unique identifier of the player."},"game_symbol":{"type":"string","description":"Symbol of the game for which free spins are being granted."},"rounds":{"type":"integer","description":"Number of free spin rounds to create."},"amount":{"type":"number","format":"float","description":"Bet amount (decimal value) for each free spin round."},"currency_code":{"type":"string","description":"Currency code (ISO 4217)."},"start_date":{"type":"string","format":"date-time","description":"Start date and time for the free spins validity period (ISO 8601 format)."},"end_date":{"type":"string","format":"date-time","description":"End date and time for the free spins validity period (ISO 8601 format)."},"bonus_code":{"type":"string","description":"Campaign ID on The Bet Brothers platform."},"brand_id":{"type":"integer","description":"Unique identifier of the brand on The Bet Brothers platform."}}}}}},"responses":{"200":{"description":"Free spin rounds successfully granted.","content":{"application/json":{"schema":{"type":"object","required":["status","bonus_id"],"properties":{"status":{"type":"string"},"bonus_id":{"type":"integer"}}}}}},"403":{"description":"Forbidden – signature does not match.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}}}}}}
```
