Açıklamalar İngilizce
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 asset.precision); the sign follows the
direction of the entry; amount_formatted is the same amount, ready to display. 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.
Bu sayfada(3)
Parametreler
Değerler doğrudan istek satırına yazılır ve URL kendiliğinden oluşur. Aşağıda her parametrenin türü, zorunlu olup olmadığı ve izin verilen değerleri var.
- integersorgudaisteğe bağlı≥ 1
Page number, starting at
1. - integersorgudaisteğe bağlı1..100
Records per page,
1..100. Defaults to 15. - integersorgudaisteğe bağlı
Show movements for a single wallet only. Ids come from
GET /wallets. - LedgerTransactionTypesorgudaisteğe bağlı
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.İzin verilen değerler - stringsorgudaisteğe bağlı≤ 32 karakter
Sort field. Defaults to the operation date. An unknown value is not an error: the list simply falls back to date ordering, newest first.
- stringsorgudaisteğe bağlı≤ 4 karakter
Sort direction. Defaults to
desc— newest operations first.İzin verilen değerler
Olası yanıtlar
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.
datazorunluThe response payload.
LedgerTransactionListLedgerTransactionList
The response payload.
itemszorunluRecords 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 when the asset of the amount is known: always for wallet movements, and for a movement that bypasses a wallet when its asset is recorded.
assetisteğe bağlıThe 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. Locking and unlocking for an order (type: lock_balance, unlock_balance) keep the money in the wallet, so the direction is that of the available balance (balance in GET /wallets): a lock is debit, an unlock is credit.
When the movement was created, ISO 8601.
entrieszorunluPostings 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), signed: negative means out; the direction is also in entry_type.
The same signed amount in whole asset units, ready to display.
assetisteğe bağlıThe asset of the posting’s wallet; its precision is the divisor for amount.
AssetAsset
The asset of the posting’s wallet; its precision is the divisor for amount.
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 — 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).
errorszorunluA 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.
İlgili içerik
Yapay zekâ için bu sayfa
API sürümü 1.0.0