Sample - Stripe API
GET/v1/transfers/{transfer}

Retrieve a transfer

Retrieves a specific transfer by its unique identifier. Use the transfer ID from a transfer creation response or transfer list to obtain its amount, destination, reversal state, and related balance information.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
transferstringrequired
The unique identifier of the transfer to retrieve.
expandarray<string>optional
Fields to expand in the response.

2 status codes
200Returns the transfer object, including its amount, reversed amount, currency, destination, reversal status, reversal list, metadata, and creation details.
amountintegerrequired
Amount in cents (or local equivalent) to be transferred.
amount_reversedintegerrequired
Amount in cents (or local equivalent) reversed (can be less than the amount attribute on the transfer if a partial reversal was issued).
balance_transactionstringoptional
Balance transaction that describes the impact of this transfer on your account balance.
createdintegerrequired
Time that this record of the transfer was first created.
currencystringrequired
Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
descriptionstringoptional
An arbitrary string attached to the object. Often useful for displaying to users.
destinationstringoptional
ID of the Stripe account the transfer was sent to.
destination_paymentstringoptional
If the destination is a Stripe account, this will be the ID of the payment that the destination account received for the transfer.
idstringrequired
Unique identifier for the object.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
metadataobjectrequired
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:transfer
reversalsobjectrequired
A list of reversals that have been applied to the transfer.
reversedbooleanrequired
Whether the transfer has been fully reversed. If the transfer is only partially reversed, this attribute will still be false.
source_transactionstringoptional
ID of the charge that was used to fund the transfer. If null, the transfer was funded from the available balance.
source_typestringoptional
The source balance this transfer came from. One of `card`, `fpx`, or `bank_account`.
transfer_groupstringoptional
A string that identifies this transaction as part of a group. See the [Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options) for details.
defaultError response.
errorobjectrequired

Error handling

transfer must identify an existing transfer. Use expand to request additional response fields when needed.