Skip to main content
GET
https://s-apis.oppigames.com/
/
game
/
bonus-list
Bonus List
curl --request GET \
  --url https://s-apis.oppigames.com/game/bonus-list \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-signature: <x-signature>' \
  --header 'x-timestamp: <x-timestamp>'
{
    "status": "RS_OK",
    "data": {
        "totalPages": 1,
        "currentPage": 1,
        "totalCount": 1,
        "result": [
            {
                "bonusId": "253c5712-1043-410c-a29e-dde9a333bc44",
                "playerId": "JAY10111111",
                "gameId": "G1729071770000",
                "type": "Fortune Guess",
                "status": 5,
                "rewardedAmount": 87000000,
                "bonusAmount": 100000000,
                "redeemAt": "2025-07-25T09:56:04.926Z",
                "createdAt": "2025-07-25T09:56:03.169Z"
            }
        ]
    }
}

Note : bonusAmount = bonusAmount * 100000
(e.g.,1000 = 100000000)
Status
  • 1 = Pending
  • 2 = Active
  • 3 = Awarded
  • 5 = Cancelled

​
Headers

​
x-api-key
string
required
A unique identifier associated with operator calling API.
​
x-signature
string
required
A SHA256 HMAC signature generated using the request body and timestamp. Format: HMAC_SHA256(JSON.stringify(data) + ’|’ + timestamp), signed using the provided secret key.
​
x-timestamp
string
required
An Unix timestamp (milliseconds) Used to verify the request’s freshness. Ensure the same value is used in signature generation.
The signature will remain valid for only 5 minutes from the provided timestamp.
​
Content-Type
string
required
Must be set to application/json.

​
Query Parameters

​
page
number
default:1
Specifies the current page number for pagination purposes.
​
limit
number
default:10
Specifies how many records to display on each page, controlling the size of each data segment.
​
gameId
string
Retrieve bonus rewards for a specific game.
​
playerId
string
Retrieve bonus rewards received by a specific player.
​
status
string
Retrieve bonus rewards received by a specific status.

​
Response

​
status
string
required
Code indicates status of the request weather it is succeed or failed. We have listed error codes here
​
data
Data Object
{
    "status": "RS_OK",
    "data": {
        "totalPages": 1,
        "currentPage": 1,
        "totalCount": 1,
        "result": [
            {
                "bonusId": "253c5712-1043-410c-a29e-dde9a333bc44",
                "playerId": "JAY10111111",
                "gameId": "G1729071770000",
                "type": "Fortune Guess",
                "status": 5,
                "rewardedAmount": 87000000,
                "bonusAmount": 100000000,
                "redeemAt": "2025-07-25T09:56:04.926Z",
                "createdAt": "2025-07-25T09:56:03.169Z"
            }
        ]
    }
}

Note : bonusAmount = bonusAmount * 100000
(e.g.,1000 = 100000000)