List all OutboundTransfer objects v2

Money Management

Outbound Transfers

List all OutboundTransfer objects

Returns a list of OutboundTransfers that match the provided filters.

Learn more about calling API v2 endpoints.

Parameters

createdtimestamp
Filter for objects created at the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.

created_gttimestamp
Filter for objects created after the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.

created_gtetimestamp
Filter for objects created on or after the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.

created_lttimestamp
Filter for objects created before the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.

created_ltetimestamp
Filter for objects created on or before the specified timestamp. Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.

limitinteger
The maximum number of results to return.

pagestring
The page token to use to retrieve the page being requested.

statusarray of enums

Closed Enum. Only return OutboundTransfers with this status.

Possible enum values

canceled

A user canceled the OutboundTransfer before posting. Stripe returns the funds to the user by voiding the pending Transaction.

failed

The OutboundTransfer failed to confirm. Stripe returns the funds to the user by voiding the pending Transaction.

posted

The OutboundTransfer posted and funds have left the account. The underlying Transaction posts.

processing

The OutboundTransfer starting state. Funds are “held” by a pending Transaction (but are still part of the current balance). The OutboundTransfer might be cancelable by the user, depending on the value of the cancelable field.

returned

The OutboundTransfer failed to successfully arrive at the destination. Funds return to the user with a second posted Transaction attached to the same flow.

Returns

Response attributes

dataarray of objects

The OutboundTransfers retrieved.

data.idstring
Unique identifier for the OutboundTransfer.

data.objectstring, value is "v2.money_management.outbound_transfer"
String representing the object’s type. Objects of the same type share the same value of the object field.

data.amountobject
The “presentment amount” for the OutboundTransfer.
- data.amount.currencystring
  A lowercase alpha3 currency code like “usd”.
- data.amount.valueinteger
  In minor units like 123 for 1.23 USD.

data.cancelableboolean
Returns true if the OutboundTransfer can be canceled, and false otherwise.

data.createdtimestamp
Time at which the OutboundTransfer was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

data.delivery_optionsnullable object
Delivery options to be used to send the OutboundTransfer.
- data.delivery_options.bank_accountnullable enum
  Method for bank account.
  Possible enum values
  automatic
  Method automatically selected by Stripe.
  local
  The group of local bank-transfer networks in the bank account’s country.
  wire
  The group of wire transfer networks in the bank account’s country.

data.descriptionnullable string
An arbitrary string attached to the OutboundTransfer. Often useful for displaying to users.

data.expected_arrival_datenullable timestamp
The date when funds are expected to arrive in the payout method. This field is not set if the payout method is in a failed, canceled, or returned state. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

data.fromobject
The FinancialAccount that funds were pulled from.
- data.from.debitedobject
  The monetary amount debited from the sender, only set on responses.
  data.from.debited.currencystring
  A lowercase alpha3 currency code like “usd”.
  data.from.debited.valueinteger
  In minor units like 123 for 1.23 USD.
- data.from.financial_accountstring
  The FinancialAccount that funds were pulled from.

data.livemodeboolean
Has the value true if the object exists in live mode or the value false if the object exists in test mode.

data.metadatanullable map
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

data.receipt_urlnullable string
A link to the Stripe-hosted receipt for this OutboundTransfer. The receipt link remains active for 60 days from the OutboundTransfer creation date. After this period, the link will expire and the receipt url value will be null.

data.statement_descriptorstring
The description that appears on the receiving end for an OutboundTransfer (for example, bank statement for external bank transfer). It will default to STRIPE if not set on the account settings.

data.statusenum

Current status of the OutboundTransfer: processing, failed, posted, returned, canceled. An OutboundTransfer is processing if it has been created and is processing. The status changes to posted once the OutboundTransfer has been “confirmed” and funds have left the account, or to failed or canceled. If an OutboundTransfer fails to arrive at its payout method, its status will change to returned.

Possible enum values

canceled

A user canceled the OutboundTransfer before posting. Stripe returns the funds to the user by voiding the pending Transaction.

failed

The OutboundTransfer failed to confirm. Stripe returns the funds to the user by voiding the pending Transaction.

posted

The OutboundTransfer posted and funds have left the account. The underlying Transaction posts.

processing

returned

The OutboundTransfer failed to successfully arrive at the destination. Funds return to the user with a second posted Transaction attached to the same flow.

data.status_detailsnullable object

Status details for an OutboundTransfer in a failed or returned state.

data.status_details.failednullable object

The failed status reason.

data.status_details.failed.reasonenum

The failed status reason.

Possible enum values

payout_method_declined

The outbound flow to this payout method was declined.

payout_method_does_not_exist

Payout method used for this outbound flow does not exist.

payout_method_expired

Payout method used for this outbound flow expired.

payout_method_unsupported

Payout method used for this outbound flow is unsupported.

payout_method_usage_frequency_limit_exceeded

The usage frequency limit for this payout method was exceeded.

unknown_failure

Unknown failure.

data.status_details.returnednullable object

The returned status reason.

data.status_details.returned.reasonenum

The returned status reason.

Possible enum values

payout_method_canceled_by_customer

The outbound flow to this payout method was canceled by customer.

payout_method_closed

Payout method account used for this outbound flow is closed.

payout_method_currency_unsupported

Currency is not supported by the payout method account.

payout_method_does_not_exist

Payout method account used for this outbound flow does not exist.

payout_method_holder_address_incorrect

Address on the payout method account is incorrect.

payout_method_holder_details_incorrect

The payout method account holder’s details are incorrect.

payout_method_holder_name_incorrect

Name on the payout method account is incorrect.

payout_method_invalid_account_number

The outbound flow to this payout method has an invalid account number.

payout_method_restricted

Payout method account used for this outbound flow is restricted.

recalled

The outbound flow to this payout method was recalled.

Show 1 more

data.status_transitionsnullable object
Hash containing timestamps of when the object transitioned to a particular status.
- data.status_transitions.canceled_atnullable timestamp
  Timestamp describing when an OutboundTransfer changed status to canceled. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
- data.status_transitions.failed_atnullable timestamp
  Timestamp describing when an OutboundTransfer changed status to failed. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
- data.status_transitions.posted_atnullable timestamp
  Timestamp describing when an OutboundTransfer changed status to posted. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.
- data.status_transitions.returned_atnullable timestamp
  Timestamp describing when an OutboundTransfer changed status to returned. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

data.toobject
To which payout method the OutboundTransfer was sent.
- data.to.creditedobject
  The monetary amount being credited to the destination.
  data.to.credited.currencystring
  A lowercase alpha3 currency code like “usd”.
  data.to.credited.valueinteger
  In minor units like 123 for 1.23 USD.
- data.to.payout_methodstring
  The payout method which the OutboundTransfer uses to send payout.

data.trace_idobjectPreview feature
A unique identifier that can be used to track this OutboundTransfer with recipient bank. Banks might call this a “reference number” or something similar.
- data.trace_id.statusenum
  Possible values are pending, supported, and unsupported. Initially set to pending, it changes to supported when the recipient bank provides a trace ID, or unsupported if the recipient bank doesn’t support it. Note that this status may not align with the OutboundPayment or OutboundTransfer status and can remain pending even after the payment or transfer is posted.
  Possible enum values
  pending
  Pending to receive TraceId information from recipient bank.
  supported
  TraceId is supported by the recipient bank.
  unsupported
  TraceId is not supported by the recipient bank.
- data.trace_id.valuenullable string
  The trace ID value if trace_id.status is supported, otherwise empty.

next_page_urlnullable string
The URL for the next page of results.

previous_page_urlnullable string
The URL for the previous page of results.

Error Codes

400invalid_page_token

Error returned when the page token provided in the OutboundPayments/OutboundTransfers list request is invalid.

GET /v2/money_management/outbound_transfers

curl -G https://api.stripe.com/v2/money_management/outbound_transfers \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-11-17.preview" \
  -d "status[0]"=processing

Response

{
  "data": [
    {
      "id": "obt_test_65OAfZuGepEX92sRECO16NybHIZ4SQ3LORe4rpuNGDIDb6",
      "object": "v2.money_management.outbound_transfer",
      "from": {
        "financial_account": "fa_test_65NybHaQx7KJxDc22rZ16NybHIZ4SQ3LORe4rpuNGDIXEO",
        "debited": {
          "value": 50,
          "currency": "usd"
        }
      },
      "to": {
        "payout_method": "usba_test_61NyccB7UY8KzlWh916NybHIZ4SQ3LORe4rpuNGDIRWC",
        "credited": {
          "value": 50,
          "currency": "usd"
        }
      },
      "delivery_options": {
        "bank_account": "automatic"
      },
      "amount": {
        "value": 50,
        "currency": "usd"
      },
      "statement_descriptor": "Stripe payout",
      "cancelable": true,
      "description": "Paying out Stripe earnings",
      "status": "processing",
      "status_transitions": {
        "canceled_at": null,
        "failed_at": null,
        "posted_at": null,
        "returned_at": null
      },
      "status_details": null,
      "created": "2023-04-26T23:19:35.123Z",
      "expected_arrival_date": "2023-04-28T00:00:00Z",
      "receipt_url": "https://payments.stripe.com/transaction_receipt/CCMaIwohd2tzcF90ZXN0XzZOeWJISVo0U1EzTE9SZTRycHVOR0RJKLnjpqIGMgZNKstJGOg6SJSQrFGi6Bb85dAepu7uG2MVwM9VElVM0ekthEzf2MRmX19dnfFuZpKcVeukNldg5CAYFdFCUWWc_AHfQyYgL7fSAUONrbxPhg",
      "livemode": false
    },
    {
      "id": "obt_test_65OAfYe4XKyMwZeHlcV16NybHIZ4SQ3LORe4rpuNGDIRZw",
      "object": "v2.money_management.outbound_transfer",
      "from": {
        "financial_account": "fa_test_65NybHaQx7KJxDc22rZ16NybHIZ4SQ3LORe4rpuNGDIXEO",
        "debited": {
          "value": 80,
          "currency": "usd"
        }
      },
      "to": {
        "payout_method": "usba_test_61NyccB7UY8KzlWh916NybHIZ4SQ3LORe4rpuNGDIRWC",
        "credited": {
          "value": 80,
          "currency": "usd"
        }
      },
      "delivery_options": {
        "bank_account": "automatic"
      },
      "amount": {
        "value": 80,
        "currency": "usd"
      },
      "statement_descriptor": "Stripe payout",
      "cancelable": false,
      "description": "Paying out Stripe earnings",
      "status": "canceled",
      "status_transitions": {
        "canceled_at": "2023-04-26T23:18:28.412Z",
        "failed_at": null,
        "posted_at": null,
        "returned_at": null
      },
      "status_details": null,
      "created": "2023-04-26T23:18:16.777Z",
      "expected_arrival_date": "2023-04-28T00:00:00Z",
      "receipt_url": "https://payments.stripe.com/transaction_receipt/CCMaIwohd2tzcF90ZXN0XzZOeWJISVo0U1EzTE9SZTRycHVOR0RJKLnjpqIGMgZ4ixuDAAY6SJQGxQoU7gIawmH6g8uvKmtgds_fctxW9OclrMHT0XrtLo5HV8bCBdjfFxZ9UIQqiEvXN78CMyXlPu5gyap_a3jtVVdFeid7vw",
      "livemode": false
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}

Need help? Contact Support.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc

List all OutboundTransfer objects v2

Parameters

createdtimestamp

created_gttimestamp

created_gtetimestamp

created_lttimestamp

created_ltetimestamp

limitinteger

pagestring

statusarray of enums

Returns

Response attributes

dataarray of objects

data.idstring

data.objectstring, value is "v2.money_management.outbound_transfer"

data.amountobject

data.amount.currencystring

data.amount.valueinteger

data.cancelableboolean

data.createdtimestamp

data.delivery_optionsnullable object

data.delivery_options.bank_accountnullable enum

data.descriptionnullable string

data.expected_arrival_datenullable timestamp

data.fromobject

data.from.debitedobject

data.from.debited.currencystring

data.from.debited.valueinteger

data.from.financial_accountstring

data.livemodeboolean

data.metadatanullable map

data.receipt_urlnullable string

data.statement_descriptorstring

data.statusenum

data.status_detailsnullable object

data.status_details.failednullable object

data.status_details.failed.reasonenum

data.status_details.returnednullable object

data.status_details.returned.reasonenum

data.status_transitionsnullable object

data.status_transitions.canceled_atnullable timestamp

data.status_transitions.failed_atnullable timestamp

data.status_transitions.posted_atnullable timestamp

data.status_transitions.returned_atnullable timestamp

data.toobject

data.to.creditedobject

data.to.credited.currencystring

data.to.credited.valueinteger

data.to.payout_methodstring

data.trace_idobjectPreview feature

data.trace_id.statusenum

data.trace_id.valuenullable string

next_page_urlnullable string

previous_page_urlnullable string