{"operator":"test-operator", "timestamp":1755680000000,
 "currency":"BRL", "limit":100, "offset":0}

{
  "status": "ok",
  "operator": "test-operator",
  "count": 1,
  "total": 60,
  "offset": 0,
  "currencies": ["BRL", "USD"],
  "games": [
    {
      "game_id": "ronda-online",
      "name": "Ronda Online",
      "studio": "greenstudios",
      "category": "LIVE",
      "demo": true, "mobile": true, "desktop": true, "freebet": true,
      "image_url": "https://greenstudios.com.br/thumbnails/300x300/ronda-online-thumb.webp",
      "currency": "BRL",
      "min_bet": …, "max_bet": …, "max_win": …,
      "freebet_limits": {…}
    }
  ]
}

count is the size of this page, total is the whole catalogue. A total larger than count means there is more: ask for the next page with offset.

freebet says whether the game accepts free bets (Free bets).

The three limits

They appear only when you send currency, hold for that currency, and are in integer cents.

Free bet limits

Also only with currency, on games with freebet: true: the range /v1/freebets/grant accepts in that currency.

"freebet_limits": {"min_amount":100, "max_amount":10000, "min_rounds":1,
                   "max_rounds":1000, "max_total":100000, "max_expiry_days":30}

amount is per round and max_total caps rounds × amount. A missing max_* field has no ceiling; a missing block means the range is unknown: do not grant.

image_url is absent when the game has no artwork. currencies is the set of currencies enabled for you.

Returns the URL to load in an iframe or redirect.

{
  "operator": "test-operator", "timestamp": 1755680000000,
  "game_id": "ronda-online",
  "player_id": "618004",
  "token": "your-session-token",
  "currency": "BRL",
  "language": "pt",
  "demo": false, "mobile": true,
  "lobby_url": "https://your-site/lobby",
  "deposit_url": "https://your-site/deposit"
}

{"status":"ok", "url":"https://…/?gameId=…&casinoId=…&session=…&lang=…"}

The URL carries a session id. Your token and player_id are not in it: we take them server to server and exchange them for that id. Open the URL within 15 minutes.

Errors: MISSING_GAME_ID, MISSING_TOKEN, MISSING_PLAYER_ID, INVALID_TOKEN (400), GAME_NOT_FOUND (404).

{
  "operator": "test-operator", "timestamp": 1755680000000,
  "freebet_id": "promo-2026-001",
  "player_id": "618004",
  "game_id": "ronda-online",
  "currency": "BRL",
  "rounds": 10, "amount": 100,
  "expires_at": "2026-11-30T23:59:59Z"
}

{
  "status": "ok",
  "freebet_id": "promo-2026-001", "grant_id": "8c1f4c2e-…",
  "state": "granted",
  "player_id": "618004", "game_id": "ronda-online", "currency": "BRL",
  "amount": 100, "rounds_total": 10, "rounds_remaining": 10,
  "expires_at": "2026-11-30T23:59:59Z", "created_at": "2026-10-19T18:00:00Z"
}

The same freebet_id with the same fields returns the original grant. With different fields: 409 FREEBET_DUPLICATE.

Each free round is a round at exactly amount, in that game and currency.

{"operator":"test-operator", "timestamp":1755680000000, "freebet_id":"promo-2026-001"}

{"status":"ok", "freebet_id":"promo-2026-001", "grant_id":"8c1f4c2e-…",
 "state":"cancelled", "rounds_total":10, "rounds_remaining":6,
 "cancelled_at":"2026-10-20T09:00:00Z"}

Rounds already played stay played. A repeated cancel returns the same 200.

{"operator":"test-operator", "timestamp":1755680000000, "freebet_id":"promo-2026-001"}

Returns the grant, in the shape of the grant response. Send player_id instead of freebet_id for the player's grants, most recent first, up to 100:

{"status":"ok", "player_id":"618004", "count":1, "freebets":[{…}]}