GuidesAPI ReferenceChangelog
API Reference

List Transactions

Retrieve a list of transactions for a specific customer.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Transaction Types

  • DEPOSIT: Fiat or crypto deposit
  • WITHDRAWAL: Fiat or crypto withdrawal
  • CONVERSION: Asset conversion (buy/sell/convert)
  • AUTO_CONVERSION: Auto-conversion rule execution
  • TRANSFER: Internal transfer between customers

TRANSFER Response
For TRANSFER transactions:

  • Sender sees a TRANSFER transaction with transaction_action: TRANSFER
  • Receiver also sees the transfer in their transaction history
  • Cross-entity transfers are supported

AUTO_CONVERSION Response
For AUTO_CONVERSION transactions, the response includes a sub_transactions array containing individual transaction steps, ordered as:

  1. DEPOSIT - Initial fiat/crypto deposit
  2. CONVERSION - Asset conversion (if applicable)
  3. WITHDRAWAL - Final fiat/crypto withdrawal (if applicable)

Note:
For SWIFT withdrawals, UETR is populated in the reference field.

Pagination
Two query parameter formats are supported:

  • Flat format (recommended): ?page=1&size=10
  • Nested format: ?pagination=page=1&size=10

Receiving virtual account

For an attributed fiat deposit, receiving_virtual_account contains virtual_account_id, nickname, and external_id. Use the VA ID as the durable reconciliation key. The nickname and external reference reflect current VA metadata, so a rename can change the label shown on an older transaction. Unset metadata is returned as an empty string.

The field is null when no VA association is available, including transactions that are not attributed fiat deposits. This does not indicate a failed payment. For an auto-conversion flow, inspect the deposit sub-transaction. Archived VAs retain their historical transaction association.

A deposit webhook carries transaction_id; query the transaction to obtain this VA object. See Virtual Accounts.

Path Params
string
required

Customer ID

Query Params
string
enum

Filter by transaction action

Allowed:
string

Public transaction ID exposed by OpenAPI. Internally this maps to order IDs
from the concrete transaction tables.

string
  • Stablecoin assets: USDC, USDT, PYUSD, RLUSD, USDG, USDP, EURC, MXNB, 1USD(1USD/USDC conversion only, deposit/withdrawal not supported)
  • Digital assets: BTC, ETH, SOL
  • Fiat currencies: USD, MXN
string

Start time for transaction creation time range filter (RFC3339/ISO 8601 format)

string

End time for transaction creation time range filter (RFC3339/ISO 8601 format)

boolean

Include transactions from all sub-accounts under the same enterprise (default: false)

pagination
object
required

Pagination query parameters.

Two query parameter formats are supported:

  • Flat format (recommended): ?page=1&size=10
  • Nested format: ?pagination=page=1&size=10

Both formats are functionally equivalent. We recommend using the flat format.

Responses

Language
Credentials
Bearer
OneMoney-HMAC-SHA256
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json