Skip to content
Linra Omni Developer Docs

List your own wallet ledger transactions

GET
/api/v1/wallet/transactions
curl --request GET \
  --url 'https://api-omni.linra.net/api/v1/wallet/transactions?page=1&pageSize=20&referenceType=Order' \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
page
integer
default: 1 >= 1
pageSize
integer
default: 20 >= 1 <= 100
fromUtc
string format: date-time
toUtc
string format: date-time
referenceType

A commission REVERSAL (a return’s clawback) posts as a Commission-typed debit — there is no separate CommissionReversal value; distinguish it from a commission credit by transactionType being Debit vs Credit.

string
Allowed values: Order ManualAdjustment Refund Topup SubscriptionPayment SubscriptionRefund SubscriptionCredit Commission

Responses

Section titled “Responses”

200

Section titled “200”

A page of ledger transactions, newest first.

Media typeapplication/json
object
state
required
string
payload
required
details
object
payload
required
object
items
Array<object>
object
id
integer format: int64
partnerId
string format: uuid
transactionType
string
Allowed values: Debit Credit InternalTransfer
amount
number format: decimal
balanceBefore
number format: decimal
balanceAfter
number format: decimal
currency
string
referenceType

A commission REVERSAL (a return’s clawback) posts as a Commission-typed debit — there is no separate CommissionReversal value; distinguish it from a commission credit by transactionType being Debit vs Credit.

string
Allowed values: Order ManualAdjustment Refund Topup SubscriptionPayment SubscriptionRefund SubscriptionCredit Commission
referenceId
string
timestamp
string format: date-time
notes
string
nullable
displayCurrency
string
nullable
rate
number
nullable
amountDisplay
number
nullable
balanceBeforeDisplay
number
nullable
balanceAfterDisplay
number
nullable
pagination
object
page
integer
pageSize
integer
totalCount
integer
totalPages
integer
Example
{
  "state": "SUCCESS",
  "payload": {
    "items": [
      {
        "transactionType": "Debit",
        "referenceType": "Order"
      }
    ]
  }
}

429

Section titled “429”

Too many requests — see the Rate limits guide. Retry after the Retry-After header (seconds).

Media typeapplication/json

The envelope every /api/v1 ERROR response uses. state carries the machine-readable error code (see the Errors guide).

object
state
required
string
payload
required

Always null on an error response.

object
details
object
Example
{
  "state": "NOT_FOUND_ORDER",
  "payload": null
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying.