Accounts9

Agents9

balance-accounts3

Counterparties5

Customers22

Documents5

External Bank Accounts4

External Wallets2

fixed-routes5

FX7

Global Payout Batches5

Health1

Liquidity6

organizations6

Quotes2

RFIs6

Sandbox6

Terms of Service3

Transfers11

Verification3

Webhooks10

Transfers

Get transfer by ID

Retrieve a transfer by ID with optional expansion of related resources.

Use the expand query parameter to include full objects instead of just IDs:

sourceAccount: Include full source account details
destinationAccount: Include full destination account details
counterparty: Include full counterparty details (for third-party transfers)
documents: Include document IDs (included by default)

Multiple expansions can be requested: ?expand=sourceAccount,destinationAccount,counterparty

get/v1/transfers/{id}

Path parameters

idstring required

Query parameters

expandstring[]

Fields to expand in the response. Pass as comma-separated values or repeated query params.

[
  "sourceAccount",
  "destinationAccount"
]

includeInternalboolean

Include internal/system-generated documents

Headers

X-API-Keystring

API key

Response

Transfer retrieved successfully

idstring required

Transfer ID (tfr_xxx)

organizationIdstring required

Organization ID

clientReferenceIdstring nullable

Client's internal reference ID

sourceCustomerIdstring required

Source customer ID

counterpartyIdstring nullable

Counterparty ID for third-party recipient transfers

agentIdstring nullable

Agent whose key created or submitted this transfer. Null when the transfer was not made by an agent key.

Transfer flow type describing the asset conversion

Transfer status

quoteIdstring nullable

Quote ID if transfer was created from a quote

exchangeRatestring nullable

Exchange rate applied to the currency conversion, inclusive of all fees. Expressed on minor-unit amounts: destinationAmount = sourceAmount * exchangeRate. Populated for FX trades.

referenceRatestring

Independent reference rate used to price this transfer, expressed as destination major units per source major unit. Present for benchmark-priced FX transfers.

referenceRateAsOfstring

Timestamp of the independent reference rate used to price this transfer (ISO 8601).

referenceProvider'XE'

Independent market that published referenceRate. Present when referenceRate is present.

developerFeeFixedstring nullable

Fixed developer fee in minor units of source currency. Prefer the developerFee object, which also carries the collected amount and payout hash.

developerFeePercentnumber nullable

Variable developer fee as decimal percentage (e.g., 0.005 = 0.5%). Prefer the developerFee object, which also carries the collected amount and payout hash.

createdAtstring date-time required

Transfer creation date

updatedAtstring date-time required

Transfer last update date

currentLegIndexnumber nullable

Index of the current active leg in the legs array (0-indexed). Null if all legs are done.

fundingNeededboolean required

Whether the transfer is waiting for the customer to send funds (deposit)

isThirdPartyboolean

Whether this is a third-party payment (destination account belongs to someone other than the customer)

remarksstring nullable

Free-form remarks or notes about the transfer

internalRemarksstring nullable

Internal remarks visible only within your organization. Never forwarded to payment rails or counterparties.

uetrstring nullable

SWIFT UETR (Universal End-to-End Transaction Reference)

imadstring nullable

Wire IMAD (Input Message Accountability Data)

omadstring nullable

Wire OMAD (Output Message Accountability Data)

achTraceNumberstring nullable

ACH trace number from the payment network

txHashstring nullable

Blockchain transaction hash

systemRemarkstring nullable

System-generated status note with important transfer context for the customer

metadataobject

Additional non-contractual transfer metadata for UI display

estimatedSettlementAtstring date-time nullable

Estimated time the recipient will receive funds. Best-effort projection — fiat rails account for bank cutoff times, weekends, and US Federal Reserve holidays; crypto conversions project from recently observed processing times for the route. Not a guarantee.

nextCutoffAtstring date-time nullable

Next time the customer can submit and still settle same business day. Past this time, transfers settle next business day.

cutoffTimezonestring nullable

IANA timezone for the cutoff time, e.g. "America/New_York".

documentIdsstring[]

IDs of documents associated with this transfer

Changes

Changed in 13 of the 19 revisions of this API.42447

Sep 24, 2026c5a90949ca596See the full diff
- ○
  added the required property /////////////////// to the response with the status
  response-required-property-added
- ○
  added the required property /////////////////// to the response with the status
  response-required-property-added
- ○
  added the required property /////////////////// to the response with the status
  response-required-property-added
- ○
  added the required property /////////////////// to the response with the status
  response-required-property-added
- ○
  added the required property ////////////// to the response with the status
  response-required-property-added
- ○
  added the required property ////////////// to the response with the status
  response-required-property-added
Sep 24, 2026bb2702829ce06See the full diff
- ●
  added the new ROBINHOOD enum value to the //////////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new ROBINHOOD enum value to the //////////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new ROBINHOOD enum value to the //////////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new ROBINHOOD enum value to the //////////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new ROBINHOOD enum value to the /////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new ROBINHOOD enum value to the /////////////// response property for the response status
  response-property-enum-value-added
Sep 23, 2026da62fa03793e3See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
Sep 22, 2026916d2367a8f8410See the full diff
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
Sep 20, 20267788dddbcb2112See the full diff
- ○
  added the optional property ///////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
Sep 19, 202616bbb87acca96See the full diff
- ○
  added the optional property /////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
Sep 18, 2026f0ba578043a94See the full diff
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
Sep 16, 2026b83888a376d81See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
Sep 16, 202603a24c5c95252See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Sep 5, 202670223aefae8c6See the full diff
- ●
  added the new LIVENESS_CHECK enum value to the //////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new LIVENESS_CHECK enum value to the //////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new LIVENESS_CHECK enum value to the //////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new LIVENESS_CHECK enum value to the //////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new LIVENESS_CHECK enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new LIVENESS_CHECK enum value to the /////// response property for the response status
  response-property-enum-value-added

Full history (13 revisions)