Sign in
Admin Users

Get user coin transactions analytics

Retrieve analytics about user coin transactions including amount deposited, amount spent, number of purchases, and current balance

get/admin/users/{id}/coin-transactions

Path parameters

idstring required
Example:user-uuid-here

User ID

Response

User coin transactions analytics retrieved successfully

userIdstring required

User ID

amountDepositednumber required

Total amount deposited

amountSpentnumber required

Total amount spent

numberOfPurchasesnumber required

Number of purchases (IN direction with PURCHASE reason)

purchasedCoinsTotalnumber required

Coins bought via in-app/coin-pack purchases (reason PURCHASE, IN), isolated from subscription grants / welcome bonus / admin deposits

refundAmountnumber required

Total amount refunded (any direction with REFUND reason)

currentBalancenumber required

Current user balance

spentByFeatureobject required

Amount spent by feature (TEXT_MESSAGE, IMAGE_REQUEST, VIDEO_REQUEST, MODEL_CREATE, LIVE_ACTION, GIFT, CALL)

spentFromMonthlynumber required

Spend (reason SPENDING) drawn from the monthly quota bucket (v2)

spentFromBonusnumber required

Spend (reason SPENDING) drawn from the purchased/bonus bucket (v2)

quotaExpirednumber required

Quota coins that expired at monthly resets (reason QUOTA_RESET, v2). Not counted in amountSpent.

Example response

{
  "userId": "user-uuid-here",
  "amountDeposited": 1000,
  "amountSpent": 500,
  "numberOfPurchases": 5,
  "purchasedCoinsTotal": 1200,
  "refundAmount": 200,
  "currentBalance": 500,
  "spentByFeature": {
    "TEXT_MESSAGE": 120,
    "IMAGE_REQUEST": 300,
    "VIDEO_REQUEST": 0,
    "MODEL_CREATE": 200,
    "LIVE_ACTION": 0,
    "GIFT": 50,
    "CALL": 400
  },
  "spentFromMonthly": 400,
  "spentFromBonus": 100,
  "quotaExpired": 200,
  "v2Balance": {
    "monthlyLeft": 800,
    "monthlyLimit": 1000,
    "bonusLeft": 250,
    "total": 1050,
    "quotaResetAt": "2026-07-01T00:00:00.000Z"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.