API Portal

πŸ‘€ User Cash Report Endpoint

The User Cash Report API provides detailed information about a single user’s cash transactions β€” total cash in/out, net balance, and the 50 most recent transactions. It’s designed for monitoring player activity and verifying cashier performance.

ℹ️ Description
  • Returns total cash in, cash out, and net balance for a specific user.
  • Includes up to 50 most recent transactions within the selected date range.
  • Supports filtering by from and to date parameters.
  • All amounts are automatically formatted in shop currency.
Endpoint
GET https://proapi.gapi.lol/api/user/{id}/cash-report
URL Parameter
{id} β†’ numeric user ID

You can obtain this user ID from the πŸ‘₯ Users Endpoint.

Example: /api/user/3154/cash-report

Query Parameters
{
  "from": "2025-11-02 00:00:00",  // optional start date (shop timezone)
  "to": "2025-11-02 23:59:59"     // optional end date (shop timezone)
}

Dates are automatically converted from shop timezone to UTC internally.

Successful Response
{
  "success": true,
  "total_in": "500.00",
  "total_out": "350.00",
  "net_balance": 150,
  "recent_transactions": [
   {
            "id": 136534,
            "date": "2025-10-30 10:59:37",
            "cashier": "cash100",
            "description": "Cashier",
            "in": "0.00",
            "out": "53.00"
        },
        {
            "id": 136533,
            "date": "2025-10-30 10:58:01",
            "cashier": "cash100",
            "description": "cancel - dik api_v1",
            "in": "50.00",
            "out": "0.00"
        },
  ],
  "period": "2025-11-02 00:00 β†’ 2025-11-02 23:59"
}
Example Request (cURL)
curl -X GET "https://proapi.gapi.lol/api/user/101/cash-report?from=2025-11-02%2000:00:00&to=2025-11-02%2023:59:59" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <your_token>"

Returns total summary and the last 50 transactions for the specified user.

Error Responses

401 Unauthorized β€” Wrong username or password:

{
  "success": false,
  "message": "Please login via API token"
}

403 Forbidden β€” Account suspended or disabled:

{
  "success": false,
  "message": "Account suspended"
}

429 Too Many Requests β€” Rate limit exceeded:

{
  "success": false,
  "message": "Too many attempts. Try again later."
}

500 Internal Server Error β€” Server-side issue:

{
  "success": false,
  "message": "Unexpected server error"
}