Skip to main content

Admin

1 API call in this section.

Get User Wallet

Billing & Subscriptions / Wallets / Admin
GET/wallets/user-wallet?user_id={{user_id}}&page=1&limit=20&type=&from_date=&to_date=&search=&language=en

Get User Wallet (Admin) Returns wallet + transaction history for a specific user (same tenant). Currency: - data.wallet.currency is resolved from Settings (currency.currency_code) using tenant override with system fallback. - Each transaction includes currency_code; when missing it is treated as the same Settings currency code. Authentication: - Requires Bearer Token authentication: Authorization: Bearer {{access_token}} (or API key) - Requires permission: tenant:wallet:management Query Parameters: - user_id, page, limit, type, from_date, to_date, search, language. Response: - Returns data.user, data.wallet, data.transactions, data.pagination.

Send a bearer token in the Authorization header for an authenticated OnDi user session.
Request
curl
1curl --request GET "$ONDI_BASE_URL/wallets/user-wallet?user_id={{user_id}}&page=1&limit=20&type=&from_date=&to_date=&search=&language=en" \2  --header "Authorization: Bearer {{access_token}}"

Query parameters

user_idOptional
query string

{{user_id}}

Target user UUID (required)

pageOptional
query string

1

Page number for pagination (default: 1)

limitOptional
query string

20

Number of items per page (default: 20, max: 100)

typeOptional
query string

Filter by transaction type: topup, transfer, payment, earning

from_dateOptional
query string

Filter from date (ISO format: 2024-01-01T00:00:00Z)

to_dateOptional
query string

Filter to date (ISO format: 2024-12-31T23:59:59Z)

searchOptional
query string

Search in description/reference fields and by exact amount when numeric

languageOptional
query string

en

Language code for response localization (Optional, default: en)

Headers

AuthorizationOptional
header string

Bearer {{access_token}}

Responses

Error - Unauthorized403Forbidden