Transactions

2 API calls in this section.

List Transactions

Billing & Subscriptions / Wallets / Transactions

GET/wallets/transactions?page=1&limit=20&type=&from_date=&to_date=&search=&language=en

List Wallet Transactions Retrieves a paginated list of wallet transactions. 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}} Query Parameters: - page, limit, type, from_date, to_date, search, language.

Send a bearer token in the Authorization header for an authenticated OnDi user session.

Request

curl

1curl --request GET "$ONDI_BASE_URL/wallets/transactions?page=1&limit=20&type=&from_date=&to_date=&search=&language=en" \2  --header "Authorization: Bearer {{access_token}}"

Path parameters

walletIdRequired

path string

uuid

UUID of the wallet to retrieve transactions for

Query parameters

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

Success Response200OK

Success Response - Filtered by Type200OK

Error - Validation Error400Bad Request

Error - Invalid Transaction Type400Bad Request

Error - Wallet Not Found404Not Found

Error - Unauthorized Access403Forbidden

Error - Unauthorized401Unauthorized

Error - Internal Server Error500Internal Server Error

Export Transactions (CSV)

Billing & Subscriptions / Wallets / Transactions

GET/wallets/transactions-export/{{user_id}}?type=&from_date=&to_date=&search=&language=en

Export Wallet Transactions (CSV) Streams a CSV export of wallet transactions for the user in the URL. Authentication: - Requires Bearer Token authentication Path Parameters: - userId (required) Authorization: - If you have tenant:wallet:management, you can export any tenant user's transactions - Otherwise you can export only your own transactions (the userId must match the authenticated user) Query Parameters: - type, from_date, to_date, search (optional) - language (optional) Response: - Content-Type: text/csv - Content-Disposition: attachment filename - X-Total-Rows: total export rows - X-Export-Tenant-Id, X-Export-Actor-User-Id, X-Export-Target-User-Id Request Body: CSV stream.

Send a bearer token in the Authorization header for an authenticated OnDi user session.

Request

curl

1curl --request GET "$ONDI_BASE_URL/wallets/transactions-export/{{user_id}}?type=&from_date=&to_date=&search=&language=en" \2  --header "Authorization: Bearer {{access_token}}" \3  --header "Accept: text/csv"

Path parameters

user_idRequired

path string

Variable used inside the request path.

Query parameters

typeOptional

query string

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

from_dateOptional

query string

Filter from date (ISO format or YYYY-MM-DD)

to_dateOptional

query string

Filter to date (ISO format or YYYY-MM-DD)

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}}

AcceptOptional

header string

text/csv

Responses

No response example is available for this endpoint yet.