Get a transaction
Returns one transaction. Poll it after a transfer until status is completed or failed; paused means the transfer needs something from you. An unknown ID returns a 400.
Path Parameters
The transaction_id from POST /v1/transfer
Responses
| Status | Description |
|---|---|
200 |
The transaction |
400 |
The request failed. Every transactions error is a 400, including not-found. |
200 response
Amount in currency, as a decimal string
Possible values: avalanche, ethereum, solana, stellar, polygon, base, sui, tron, ach, wire, rtp, swift, sepa, bank_transfer, mobile_money, internal, swap, card, card_funding, card_withdrawal, card_payment, savings, savings_withdrawal, savings_interest, otc
The client_metadata sent with the transfer
Possible values: in, out
Details that depend on the transaction type. Empty fields can be null or left out.
Local equivalent amount as a decimal string
ISO 4217 currency code for local_amount
Unique end-to-end transaction reference (SWIFT UETR)
The transfer reference
Why it failed, when known
paused means the transfer needs something from you; see POST /v1/transfer/{id}/resume. A returned payment keeps completed, and the return appears as a new transaction.
Possible values: pending, completed, failed, waiting_approval, paused
US payouts are bank_account; refunds are transfer_refund.
Possible values: internal_transfer, crypto_transfer, crypto_funding, global_remittance, ach_transfer, wire_transfer, sepa_transfer, swift_transfer, fps_transfer, bank_transfer, bank_account, mobile_money, card_funding, card_withdrawal, card_payment, card_collection, account_funding, credit, debit, fee_charge, subscription_fee, invoice_payment, otc, transfer_refund, stablecoin_conversion
Blockchain transaction hash
{
"data": {
"id": "8d4e2b6c-1f3a-4e7b-b0c9-5a6d7e8f9a01",
"customer_id": "bb6c6022-f1d8-492f-80f0-7547134bb42f",
"amount": "250",
"currency": "USD",
"date_created": "2026-10-13T09:15:22.9Z",
"direction": "out",
"transaction_type": "global_remittance",
"description": "Invoice 114",
"sending_account_id": "b9c2cb0d-e09a-496f-8655-d8c4b7aaf2f8",
"sending_account_name": "Acme Ops USD",
"sending_account_number": "4000123456",
"receiving_account_id": null,
"reference": "3f0c6a8e-6b1d-4c1e-9a55-0d2f7b9e4a11",
"tenant_id": "89fa0d5e-3acf-4834-968f-6a9f0186ab59",
"channel": "bank_transfer",
"status": "pending",
"remark": null,
"client_reference": "inv-114",
"fee": "1.5",
"tx_hash": null,
"metadata": {
"recipient_name": "Ada Obi",
"local_amount": "382500",
"local_amount_currency": "NGN"
},
"external_id": null,
"balance_before": "10000",
"balance_after": "9748.5",
"client_metadata": null
},
"error": null
}
400 response
{
"data": null,
"error": "invalid request params"
}
Authorization
- ApiKeyAuth