Get bonuses the player is eligible for

Returns a list of bonus types that the player can currently claim based on their status, activity, and eligibility rules.

GET /players/{playerId}/bonuses/eligible

Get bonuses the player is eligible for

cURL

curl --request GET \
  --url https://mock-api.cevro.ai/v1/players/{playerId}/bonuses/eligible \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Session-ID: <x-session-id>'

200

{
  "player_id": "<string>",
  "bonuses": [
    {
      "bonus_type_id": "<string>",
      "name": "<string>",
      "code": "<string>",
      "description": "<string>",
      "benefit_type": "<string>",
      "amount": 123,
      "wager_requirement": 123,
      "expires_at": "2023-11-07T05:31:56Z",
      "reason": "<string>"
    }
  ],
  "total": 123
}

Authorizations

bearerAuthsessionAuth

Authorization · string · header · required

API Bearer token. For this demo, any non-empty string is accepted.

Headers

X-Session-ID · string · required

Path Parameters

playerId · string · required

Query Parameters

criteria_type · enum<string>

Filter by eligibility criteria type

Available options: LOGIN, DEPOSIT, VIP, LOYALTY

Response

200

application/json

Eligible bonuses retrieved successfully

player_id · string

bonuses · object[]

Show child attributes

total · integer