Query Member Report

Query the statistical report grouped by member.

API Information

• URL：POST /v2/report/user
• Authentication：Bearer Token
• Encryption：Requests are encrypted using AES-256-GCM; responses are returned as plaintext JSON

request

request Headers

POST /v2/report/user HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769746894501
x-nonce: 4ff08bc2a45c6b38068dbcd24296a25b
x-signature: c25f8d23704373e8776cce6d9b10f1fde091c34db80d60523c7e04ff30e54633

Request Parameters

Request Body Before Encryption

{
  "startDate": "2026-01-21T07:00:00Z",
  "endDate": "2026-01-21T07:30:00Z",
  "agentId": "integratorNBTest04",
  "betSource": 1
}

Encrypted Request Body

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}

Field	Type	Required	Description
startDate	string	Yes	Betlog start time
endDate	string	Yes	Betlog end time
agentId	string	Yes	agentId
betSource	number	No	Filter type，default: 1，1：General and Item、2：Operator Card

Response

Success Response

{
  "code": 0,
  "message": "No error.",
  "data": [
    {
      "agentId": "integratorNBTest04",
      "brand": "VP",
      "username": "VPSysDevTest001",
      "currency": "THB",
      "count": 96,
      "actualBetAmt": "48",
      "validBetAmt": "48",
      "winAmt": "44.9",
      "ggr": "3.1",
      "jackpotWin": "0",
      "jackpotContribute": "0",
      "lastStatisticsTime": "2026-02-02T23:29:44.621Z"
    },
    {
      "agentId": "integratorNBTest04",
      "brand": "VP",
      "username": "VPSysDevTest002",
      "currency": "THB",
      "count": 96,
      "actualBetAmt": "4",
      "validBetAmt": "4",
      "winAmt": "4",
      "ggr": "3",
      "jackpotWin": "0",
      "jackpotContribute": "0",
      "lastStatisticsTime": "2026-02-02T23:29:44.621Z"
    }
  ],
  "logUUID": "146c3bf2-ce4b-4154-a550-f3f37c1068fc"
}

Field	Type	Description
data	array	Member Report List
data[].agentId	string	agentId
data[].brand	string	Game Brand
data[].username	string	Player Account
data[].currency	string	Currency
data[].count	number	Number of bets
data[].actualBetAmt	string	Actual bet amount
data[].validBetAmt	string	Valid bet amount
data[].winAmt	string	Payout of this bet
data[].ggr	string	Game netwin
data[].jackpotWin	string	Jackpot prize which was win
data[].jackpotContribute	string	Jackpot contribute
data[].lastStatisticsTime	string	Last statistics time
logUUID	string	Request tracking ID for troubleshooting and log queries

Error Response

When the request fails, the corresponding error code will be returned.

Error Codes

Code	Description	Handling Suggestion
11	Parameters error	Ensure that all request parameters are complete and correctly formatted

Error Response Example

{
  "code": 11,
  "message": "Parameters error",
  "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

Important Notes

1. Time Range: To ensure data consistency, the query time range must be between 90 days before the current time and 2 hours before the current time
2. Time Interval: The time range set by startDate and endDate must not exceed 7 days
3. Call Frequency: Each agentId is limited to a maximum call rate of once per second
4. Time Granularity: Queries are aggregated by hour. Any partial hour will be calculated as the full hour +1
   • Example: A query from 04:00 to 04:01 will actually return data from 04:00 to 05:00
5. Query Restriction: The query must use the same agentId as the one used during /v2/auth authentication

Related APIs

• get Daily Report
• Get BetLog