GEThttps://api.spirestock.com/api/v1/wallet/balance#
The caller's wallet (or user_id's; customer tokens always get their own), created on first read, with the last 10 completed transactions and pending_requests (count and amount of recharge requests awaiting review). With all=1: every wallet in the workspace, highest balance first, each with its user; needs the Amount to be paid (12) list grant, and customers get 403. Not paged. Balances are decimal strings.
Access: API key read scope; any staff user, for their own records.
Parameters
user_idnumber- Whose wallet. Default: the caller
allstring- 1 for every wallet in the workspace
curl https://api.spirestock.com/api/v1/wallet/balance \
-H "X-API-Key: YOUR_API_KEY"{
"response_code": 200,
"data": {
"wallet": {
"id": 7,
"organization_id": 6,
"user_id": 51896,
"balance": "1500.00",
"auto_debit_enabled": true,
"low_balance_threshold": "100.00",
"last_recharged_at": "2026-10-22T08:45:58.733Z",
"status": 1,
"createdAt": "2026-10-22T08:44:08.294Z",
"updatedAt": "2026-10-22T08:45:58.733Z"
},
"transactions": [
{
"id": 6,
"organization_id": 6,
"wallet_id": 7,
"user_id": 51896,
"type": "recharge",
"amount": "1500.00",
"balance_after": "1500.00",
"reference_type": "recharge_request",
"reference_id": null,
"payment_mode": "UPI",
"payment_gateway_id": null,
"notes": "Paid at the bank counter",
"status": "completed",
"utr_reference": "UTR000000001",
"receipt_media_id": null,
"receipt_url": null,
"requested_by": 51896,
"approved_by": 51897,
"rejected_by": null,
"reviewed_at": "2026-10-22T08:45:58.732Z",
"reject_reason": null,
"createdAt": "2026-10-22T08:45:58.667Z",
"updatedAt": "2026-10-22T08:45:58.734Z"
}
],
"pending_requests": {
"count": 0,
"amount": 0
}
}
}