Skip to main content

CreateFreeRoundsRequest

extIDstringrequired

Free rounds ID (external). Used as idempotency key. Same ID can be used to create free rounds only once.

Example: free_rounds_id
cIDuuidrequired

Client's ID (internal)

extCIDstringrequired

External Client's ID (game aggregator or casino)

Example: your_ext_id
gameIDsstring[]

List of game IDs. If not provided, free rounds will be available for all games.

Example: ["sg_catch_97","sg_swipe_97"]
userIDsstring[]

List of player IDs (external). If not provided, free rounds will be available for all players.

Example: ["player123","player456"]
currencystringrequired

Currency code in ISO4217

Example: USD
quantityint32required

Number of free rounds.

Possible values: >= 1 and <= 99

Example: 10
betLineint32required

Number of bet line configured for this game/provider. You can find more information in related section Free Rounds Bet Lines.

Possible values: >= 1 and <= 99

Example: 20
validFromdate-timerequired

Start date when free rounds become available.

Example: 2026-01-01T00:00:00.000Z
validUntildate-time

End date when free rounds become unavailable. If not provided then this campaign never ends. If you provide finite validity duration, it should not exceed 30 days.

Example: 2026-02-28T23:59:59.999Z
CreateFreeRoundsRequest
{
  "extID": "free_rounds_id",
  "cID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "extCID": "your_ext_id",
  "gameIDs": [
    "sg_catch_97",
    "sg_swipe_97"
  ],
  "userIDs": [
    "player123",
    "player456"
  ],
  "currency": "USD",
  "quantity": 10,
  "betLine": 20,
  "validFrom": "2026-01-01T00:00:00.000Z",
  "validUntil": "2026-02-28T23:59:59.999Z"
}