List Transactions
The key owner's money movements: top-ups, charges for completed orders, refunds and referral rewards. Newest first, paginated.
Amounts are in the asset's minor units (see precision); the sign follows the
direction of the entry. The public payload omits the full wallet object and keeps
wallet_id.
This endpoint exists only while the wallet feature is enabled; otherwise 404.
Required key permission: billing.read.
On this page(3)
Parameters
Values go straight into the request line, and the URL is built for you. Below are each parameter’s type, whether it is required, and its allowed values.
- integerin queryoptional≥ 1
Page number, starting at
1. - integerin queryoptional1..100
Records per page,
1..100. Defaults to 15. - integerin queryoptional
Show movements for a single wallet only. Ids come from
GET /wallets. - LedgerTransactionTypein queryoptional
Filter by movement type. The full set of accepted values ships in the
LedgerTransactionTypeschema; the common ones aredeposit(top-up),order_completion(charge for a finished order),order_refund(refund) andreferral_reward.An unknown value returns
422.Allowed values - stringin queryoptional≤ 32 chars
Sort field. Defaults to the operation date. An unknown value is not an error: the list simply falls back to date ordering, newest first.
- stringin queryoptional≤ 4 chars
Sort direction. Defaults to
desc— newest operations first.Allowed values
Possible responses
200Success. The payload is in data.
Success. The payload is in data.
{
"success": true,
"message": "string",
"data": {
"items": [
{
"id": "string",
"type": "string",
"status": "string",
"description": "string",
"amount": "string",
"amount_formatted": 1,
"asset": {
"id": 1,
"code": "string",
"kind": null,
"precision": 1,
"name": null,
"is_active": true,
"is_default": true,
"default_balance": 1,
"deleted_at": "2026-07-17T12:34:56+00:00",
"created_at": "2026-07-17T12:34:56+00:00",
"updated_at": "2026-07-17T12:34:56+00:00"
},
"direction": "string",
"created_at": "string",
"entries": [
{
"id": null,
"wallet_id": null,
"amount": null,
"amount_formatted": null,
"asset": null,
"entry_type": null,
"metadata": null,
"created_at": null,
"wallet": null
}
],
"actor_user_id": "string",
"metadata": "string"
}
],
"current_page": 1,
"last_page": 1,
"per_page": 1,
"total": 1
}
}Success flag. Branch on the HTTP status code instead: any 2xx response carries true here, while an error comes back in a different shape that need not contain this field at all.
A human-readable note in the account language. Fine to show to a user; do not parse it — the wording changes without notice and is not an error code.
datarequiredThe response payload.
LedgerTransactionListLedgerTransactionList
The response payload.
itemsrequiredRecords on the current page, in the list’s sort order.
array<LedgerTransaction>LedgerTransaction
Records on the current page, in the list’s sort order.
ID of the money movement.
Movement type — a LedgerTransactionType value: deposit (top-up), order_completion (charge for an order), order_refund (refund), policy_block_fee (fee for an attempt rejected by the content policy), and others.
Movement state: posted — booked, pending — awaiting booking, void — cancelled, with no effect on the balance.
A description of the movement in words, for display. null when there is none.
Movement amount as an integer in the asset’s minor units (asset.precision), unsigned — the direction is in direction. Absent when the amount cannot be determined.
The same amount in whole asset units, ready to display. Present only when the asset of the amount is known (wallet movements lack it — take the divisor from asset.precision of the entries[].wallet_id wallet in GET /wallets).
assetoptionalThe asset of the amount; its precision is the divisor for amount. Present under the same conditions as amount_formatted.
AssetAsset
The asset of the amount; its precision is the divisor for amount. Present under the same conditions as amount_formatted.
Internal identifier of the asset.
Asset code: LUMC is the internal currency, TOKEN the generation tokens.
Kind of asset: money or consumable units. It decides whether an amount counts as a payment or as quota consumption.
Number of decimal places. The load-bearing field: every integer amount in this asset is divided by 10^precision to obtain the real value. Do not assume the divisor is 100.
Display name of the asset, in the account language.
When the asset was retired, ISO 8601. null while it is in use.
When the asset was created, ISO 8601.
When the asset last changed, ISO 8601.
credit — money in, debit — money out. The exception is locking and unlocking for an order (type: lock_balance, unlock_balance): the money never leaves the wallet, both postings sit on it, and direction carries no meaning — go by type.
When the movement was created, ISO 8601.
entriesoptionalPostings to your wallets. A movement that bypasses a wallet (such as a direct subscription payment) has an empty list; the amount is then on the transaction itself.
array<LedgerEntry>LedgerEntry
Postings to your wallets. A movement that bypasses a wallet (such as a direct subscription payment) has an empty list; the amount is then on the transaction itself.
Posting ID.
The posting’s wallet — an id from GET /wallets.
Posting amount as an integer in the wallet asset’s minor units (the divisor is asset.precision of the wallet_id wallet in GET /wallets); the direction is in entry_type.
credit — into the wallet, debit — out of it.
When the posting was created, ISO 8601.
Current page number, starting from one.
Number of the last page. The walk is over once current_page equals last_page.
Page size the server applied.
Total number of records matching the filter.
401The key is missing, unknown, disabled or expired.
The key is missing, unknown, disabled or expired.
{
"success": false,
"message": "API key is missing. Provide it in the X-API-KEY header.",
"data": null
}Always false in error responses.
Error text in the key's language (set through the X-Locale header).
Always null when the request is rejected before processing.
403The key lacks the required permission, or the object belongs to another user.
The key lacks the required permission, or the object belongs to another user.
{
"success": false,
"message": "This API key does not have permission to perform this action."
}Always false in error responses.
Error text in the key's language (set through the X-Locale header).
422Validation error. Offending fields are listed in errors.
Validation error. Offending fields are listed in errors.
{
"success": true,
"message": "string",
"errors": {}
}Always false in error responses.
A summary of the validation errors in words, in the response language (X-Locale).
errorsrequiredA per-field breakdown: the key names a request field, the value lists the complaints about it.
object
A per-field breakdown: the key names a request field, the value lists the complaints about it.
Nearby
This page for AI
API version 1.0.0