Skip to main content

List transactions

GEThttps://api.radom.com/transactions

Authorization

Send your API key in the Authorization header. Scheme: radomToken.

Parameters

isTestModebooleanquery
kindsTransactionKind[]query
statusesTransactionStatus[]query
networksNetwork[]query
withdrawalTypesTransferType[]query
offsetinteger<int64>query
limitinteger<int64>query
fromstring<date-time>query
tostring<date-time>query
searchstringquery

Responses

200Transactions retrieved successfully
dataTransaction[]required
idstring<uuid>required
organizationIdstring<uuid>required
kindTransactionKindrequired
AllowedPayoutWithdrawalDepositPaymentRefundSwapCreditDebit
createdAtstring<date-time>required
payloadTransactionPayloadnullable
idstring<uuid>required

The balance ledger transaction the adjustment booked.

organizationIdstring<uuid>required
eventTypeManagedEventTyperequired
AllowedpaymentopenBankingwithdrawalrecurringPaymentpaymentTransactionDetectedpaymentTransactionConfirmednewSubscriptionincompletePaymentsubscriptionCancelledsubscriptionExpiredrefundsubscriptionPaymentsubscriptionPaymentAttemptFailuresubscriptionPaymentRemindersubscriptionPaymentOverdueorganizationVerifiedorganizationRejectedorganizationRequireMoreDataorganizationVerificationEditedorganizationDocumentChangedonramppayoutdepositconversion
eventDataJsonrequired
eventDatestring<date-time>required
relatedCustomerRelatedCustomernullable
idstring<uuid>required
namestringrequired
emailstringrequired
amountsBreakdownManagedEventAmountBreakdownnullable
networkFeestringrequired
networkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
amountstringrequired
netAmountstringnullable
feeAmountstringnullable
currencyCurrencynullable
AllowedUSDCADGBPEURAEDINRSEKBRLNZDAUDHKDNOKDKKJPYCNYCHFSGDPLNMXNCZKHUFZARSARRUBTRYILSUSDCUSDTEURCBTCTEST0ETHBNBSOLTRXAVAXMATIC
onrampFeestringnullable
onrampGrossAmountstringnullable
onrampNetAmountstringnullable
onrampNetworkNetworknullable
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
onrampTokenstringnullable
depositAccountIdstring<uuid>required
depositAccountNamestringrequired
depositMethodDepositMethodrequired
CryptoCryptoDepositMethodrequired
networkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
tokenstringnullable
FiatFiatDepositMethodrequired
fiatCurrencyNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
onrampNetworkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
onrampTokenstringnullable
fiatGrossAmountnumber<float>nullable>= 0

Fiat gross amount, populated only for fiat deposits

grossAmountnumber<float>required>= 0
netAmountnumber<float>required>= 0
feenumber<float>required>= 0
conversionRatesConversionRate[]required
fromstringrequired
tostringrequired
ratenumber<float>required>= 0
depositedAtstring<date-time>required
statusSwapStatusrequired
AllowedPendingInitiatedFailedFinalized
depositTransactionDepositTransactionDetailsnullable
networkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
transactionHashstringrequired
tokenstringnullable
amountnumber<float>required>= 0
blockTimestampstring<date-time>required
senderAddressesSenderAddress[]required
addressstringrequired
networkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
tokenstringnullable
withdrawalAmountnumber<float>required>= 0
withdrawalAddressstringrequired
withdrawalAccountIdstring<uuid>nullable
withdrawalAccountNamestringnullable
requestedAtstring<date-time>required
withdrawalStatusWithdrawalStatusrequired
AllowedpendingprocessingcompletefailedpendingApprovalinReviewawaitingInventory
completedAtstring<date-time>nullable
receiptWithdrawalReceiptnullable
EVMReceiptEVMReceiptrequired
transactionHashstringnullable
networkFeeAmountnumber<float>nullable>= 0
BTCReceiptBTCReceiptrequired
transactionIdstringnullable
networkFeeAmountnumber<float>nullable>= 0
BSVReceiptBSVReceiptrequired
transactionIdstringnullable
networkFeeAmountnumber<float>nullable>= 0
DOGEReceiptDOGEReceiptrequired
transactionIdstringnullable
networkFeeAmountnumber<float>nullable>= 0
LTCReceiptLTCReceiptrequired
transactionIdstringnullable
networkFeeAmountnumber<float>nullable>= 0
BCHReceiptBCHReceiptrequired
transactionIdstringnullable
networkFeeAmountnumber<float>nullable>= 0
XMRReceiptXMRReceiptrequired
transactionIdstringnullable
networkFeeAmountnumber<float>nullable>= 0
SOLReceiptSOLReceiptrequired
signaturestringnullable
networkFeeAmountnumber<float>nullable>= 0
DOTReceiptDOTReceiptrequired
transactionHashstringnullable
networkFeeAmountnumber<float>nullable>= 0
FiatReceiptFiatReceiptrequired
finalAmountstringnullable
transferMethodTransferMethodnullable
AllowedSepaAchWire
flatFeenumber<float>nullable>= 0
percentFeenumber<float>nullable>= 0
transactionHashstringnullable
treasuryIdstring<uuid>nullable
failureReasonstringnullable
isTestModebooleanrequired
accountTypePayoutAccountTypenullable
Allowedbusinessindividual
deductFeesbooleanrequired
sendEmailReceiptsbooleanrequired
totalAmountUsdnumber<float>required
estimatedFeeUsdnumber<float>required
reservedFeeUsdnumber<float>nullable

What confirm reserved for the fee: the estimate plus padding. The final fee is `actual_fee_usd` once the batches are sent, and the unused part of the reserve is back in the balance.

actualFeeUsdnumber<float>nullable
feeSettledAtstring<date-time>nullable
entryCountinteger<int32>required
fundingCurrencystringnullable
fundingAssetPayoutFundingAssetnullable
fundingWithdrawalIdsstring[]
fundingConversionIdsstring[]

Ledger transaction ids of the conversions that funded hedged entries.

fundingConversionErrorstringnullable

Why the funding conversion failed, when the payout ended Failed there.

processingStagestringnullable

Merchant-facing description of where a processing payout currently is (e.g. "Converting funds", "Paying recipient").

cryptoEntriesCryptoPayoutEntry[]required
idstring<uuid>required
statusPayoutEntryStatusrequired
AllowedPendingProcessingCompleteInReviewFailed
amountnumber<float>required
initialAmountnumber<float>nullable
customerIdstring<uuid>nullable
networkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
tokenstringnullable
payoutAddressstringrequired
txHashstringnullable
externalAccountIdstring<uuid>nullable
fundingCurrencyPayoutFundingCurrencynullable
failureReasonstringnullable
fiatEntriesFiatPayoutEntry[]required
idstring<uuid>required
statusPayoutEntryStatusrequired
AllowedPendingProcessingCompleteInReviewFailed
amountnumber<float>required
initialAmountnumber<float>nullable
customerIdstring<uuid>nullable
currencyCurrencyrequired
AllowedUSDCADGBPEURAEDINRSEKBRLNZDAUDHKDNOKDKKJPYCNYCHFSGDPLNMXNCZKHUFZARSARRUBTRYILSUSDCUSDTEURCBTCTEST0ETHBNBSOLTRXAVAXMATIC
ibanstringnullable
sortCodestringnullable
bankCodestringnullable
bbanstringnullable
beneficiaryEmailstringrequired
beneficiaryNamestringnullable
beneficiaryCountrystringnullable
beneficiaryDobstringnullable
beneficiaryCompanyNamestringnullable
beneficiaryAddressLine1stringnullable
beneficiaryAddressLine2stringnullable
beneficiaryCitystringnullable
beneficiaryPostalCodestringnullable
beneficiaryStatestringnullable
externalAccountIdstring<uuid>nullable
failureReasonstringnullable
autoConfirmboolean

The merchant asked for the payout to go out: it was created with `autoConfirm`, or confirmed while a recipient was still being checked. Such a payout still awaiting confirmation is waiting on screening, not on the merchant.

createdAtstring<date-time>required
confirmedAtstring<date-time>nullable
expiresAtstring<date-time>required
withdrawalIdstring<uuid>nullable
associatedEntityTypeAssociatedEntityTyperequired
AllowedPaymentLinkOrderCheckoutSessionInvoicePaymentSessionSubscriptionDonationLinkOrder
associatedEntityIdstring<uuid>required
amountstringrequired

Always positive; `kind` says which way it went.

chargeCustomerNetworkFeebooleanrequired
recipientAddressstringnullable
recipientAccountJsonnullable
ivyOrderIdstringnullable
initiatedByUserIdstring<uuid>nullable
initiatedByAdminUserIdstring<uuid>nullable
orgIdstring<uuid>required
swapSettingsIdstring<uuid>nullable
externalIdstringnullable
fromNetworkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
fromTokenstringnullable
fromAmountstringrequired
fromTransactionIdstring<uuid>nullable
fromTxidstringnullable
toNetworkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
toTokenstringnullable
toTransactionIdstring<uuid>nullable
toTxidstringnullable
toAmountstringnullable
swapFeestringnullable
failReasonstringnullable
providerSwapProviderrequired
AllowedFixedFloatOKXPegasusSwapBastionScrypt
updatedAtstring<date-time>required
fundsAvailableboolean

True once the destination balance has been credited — for instantly settled conversions that happens at confirmation, before the provider legs finish. Populated by the transactions manager, not stored.

adjustmentIdstring<uuid>required

Radom's reference for the adjustment.

kindTransactionKindrequired
AllowedPayoutWithdrawalDepositPaymentRefundSwapCreditDebit
appliedAtstring<date-time>required
totalinteger<int64>required
400Bad Request
errorstringrequired
401Unauthorized
errorstringrequired
500Internal server error
errorstringrequired