List all ReceivedCredit objects v2

Money Management

Received Credits

List all ReceivedCredit objects

Retrieves a list of ReceivedCredits.

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 page limit.

pagestring
The page token.

Returns

Response attributes

dataarray of objects

The retrieved ReceivedCredits.

data.idstring
Unique identifier for the ReceivedCredit.

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

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

data.balance_transfernullable object
This object stores details about the originating Stripe transaction that resulted in the ReceivedCredit. Present if type field value is balance_transfer.
- data.balance_transfer.from_accountnullable string
  The ID of the account that owns the source object originated the ReceivedCredit.
- data.balance_transfer.outbound_paymentnullable string
  The ID of the outbound payment object that originated the ReceivedCredit.
- data.balance_transfer.outbound_transfernullable string
  The ID of the outbound transfer object that originated the ReceivedCredit.
- data.balance_transfer.payout_v1nullable string
  The ID of the payout object that originated the ReceivedCredit.
- data.balance_transfer.typeenum
  The type of Stripe Money Movement that originated the ReceivedCredit.
  Possible enum values
  outbound_payment
  Balance transfer initiated by v2 outbound payment.
  outbound_transfer
  Balance transfer initiated by v2 outbound transfer.
  payout_v1
  Balance transfer initiated by v1 payouts request.

data.bank_transfernullable object

This object stores details about the originating banking transaction that resulted in the ReceivedCredit. Present if type field value is bank_transfer.

data.bank_transfer.financial_addressstring
Financial Address on which funds for ReceivedCredit were received.

data.bank_transfer.gb_bank_accountnullable object
Hash containing the transaction bank details. Present if origin_type field value is gb_bank_account.
- data.bank_transfer.gb_bank_account.account_holder_namenullable string
  The bank name the transfer was received from.
- data.bank_transfer.gb_bank_account.bank_namenullable string
  The bank name the transfer was received from.
- data.bank_transfer.gb_bank_account.last4nullable string
  The last 4 digits of the account number that originated the transfer.
- data.bank_transfer.gb_bank_account.networkenum
  The money transmission network used to send funds for this ReceivedCredit.
  Possible enum values
  fps
  Funds received via FPS (Faster Payment System) network.
- data.bank_transfer.gb_bank_account.sort_codenullable string
  The sort code of the account that originated the transfer.

data.bank_transfer.origin_typeenum

Indicates the origin of source from which external funds originated from.

Possible enum values

gb_bank_account

Funds received from a UK based bank account. See more details in the field “gb_bank_account”.

sepa_bank_account

Funds received from a SEPA bank account. See more details in the field “sepa_bank_account”.

us_bank_account

Funds received from a U.S. based bank account. See more details in the field “us_bank_account”.

data.bank_transfer.sepa_bank_accountnullable object
Hash containing the transaction bank details. Present if origin_type field value is sepa_bank_account.
- data.bank_transfer.sepa_bank_account.account_holder_namenullable string
  The account holder name of the bank account the transfer was received from.
- data.bank_transfer.sepa_bank_account.bank_namenullable string
  The bank name the transfer was received from.
- data.bank_transfer.sepa_bank_account.bicnullable string
  The BIC of the SEPA account.
- data.bank_transfer.sepa_bank_account.countrynullable enum
  The origination country of the bank transfer.
- data.bank_transfer.sepa_bank_account.ibannullable string
  The IBAN that originated the transfer.
- data.bank_transfer.sepa_bank_account.networkenum
  The money transmission network used to send funds for this ReceivedCredit.
  Possible enum values
  sepa_credit_transfer
  Funds received via SEPA network.

data.bank_transfer.statement_descriptornullable string
Freeform string set by originator of the external ReceivedCredit.

data.bank_transfer.us_bank_accountnullable object
Hash containing the transaction bank details. Present if origin_type field value is us_bank_account.
- data.bank_transfer.us_bank_account.bank_namenullable string
  The bank name the transfer was received from.
- data.bank_transfer.us_bank_account.last4nullable string
  The last 4 digits of the account number that originated the transfer.
- data.bank_transfer.us_bank_account.networkenum
  The money transmission network used to send funds for this ReceivedCredit.
  Possible enum values
  ach
  Funds received via ACH (Automated Clearing House) network.
  rtp
  Funds received via the RTP (Real Time Payments) network.
  us_domestic_wire
  Funds received via the Fedwire domestic US network.
- data.bank_transfer.us_bank_account.routing_numbernullable string
  The routing number of the account that originated the transfer.

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

data.descriptionnullable string
Freeform string set by originator of the ReceivedCredit.

data.financial_accountstring
Financial Account ID on which funds for ReceivedCredit were received.

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.receipt_urlnullable string
A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.

data.statusenum

The status of the ReceivedCredit.

Possible enum values

failed

The ReceivedCredit was rejected by Stripe and funds don’t change existing balance. More details why it failed can be obtained from status_details field.

pending

The ReceivedCredit was successfully processed. However, the funds are not yet available for use. More details why it is pending can be obtained from status_details field.

returned

The ReceivedCredit was returned to the originator bank and the balance has been adjusted by deducting the original ReceivedCredit amount. More details why it was returned can be obtained from status_details field.

succeeded

The ReceivedCredit was successfully processed and balance reflects the received funds.

data.status_detailsnullable object

This hash contains detailed information that elaborates on the specific status of the ReceivedCredit. e.g the reason behind a failure if the status is marked as failed.

data.status_details.failednullable object

Hash that provides additional information regarding the reason behind a failed ReceivedCredit status. It is only present when the ReceivedCredit status is failed.

data.status_details.failed.reasonenum

The failed status reason.

Possible enum values

capability_inactive

Funds rejected because the Financial Address feature on the associated Financial Account is inactive. Contact Stripe to re-enable the capability.

currency_unsupported_on_financial_address

Funds were rejected due to a discrepancy between the currency of the funds and the supported currencies of the Financial Address.

financial_address_inactive

Funds rejected because associated Financial Address that has been archived.

stripe_rejected

Funds rejected by internal Stripe rules.

data.status_details.returnednullable object
Hash that provides additional information regarding the reason behind a returned ReceivedCredit status. It is only present when the ReceivedCredit status is returned.
- data.status_details.returned.reasonenum
  The returned status reason.
  Possible enum values
  originator_initiated_reversal
  Funds were returned due to a request for reversal by the originating bank.

data.status_transitionsnullable object
Hash containing timestamps of when the object transitioned to a particular status.
- data.status_transitions.failed_atnullable timestamp
  Timestamp describing when the ReceivedCredit was marked as failed. 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 the ReceivedCredit 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.status_transitions.succeeded_atnullable timestamp
  Timestamp describing when the ReceivedCredit was marked as succeeded. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

data.typeenum

The type of flow that caused the ReceivedCredit.

Possible enum values

balance_transfer

Funds received via internal Stripe balance transfer.

bank_transfer

Funds received as a bank transfer from external rails, such as ACH, Wire, RTP, etc.

external_credit

Replaced by BANK_TRANSFER, kept for backwards compatibility.

next_page_urlnullable string
The next page url.

previous_page_urlnullable string
The previous page url.

Error Codes

404not_found

The resource wasn’t found.

GET /v2/money_management/received_credits

curl https://api.stripe.com/v2/money_management/received_credits \
  -H "Authorization: Bearer sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2" \
  -H "Stripe-Version: 2025-11-17.preview"

Response

{
  "data": [
    {
      "id": "rc_61O18kMR4G9BiyFkn16NsjVW2gfQu2lIgkGQVy6ueCx6",
      "object": "v2.money_management.received_credit",
      "financial_account": "fa_65NvHabRWMmVKVjernQ16NsjgsfdSQu2lIgkGQVy6ueDtY",
      "amount": {
        "value": 100,
        "currency": "usd"
      },
      "description": "Weekly transfer 1",
      "type": "bank_transfer",
      "bank_transfer": {
        "origin_type": "us_bank_account",
        "statement_descriptor": "Fund Stripe account 05/12",
        "us_bank_account": {
          "last4": "4557",
          "routing_number": "011000022",
          "bank_name": "Goldman Sachs",
          "network": "ach"
        },
        "financial_address": "finaddr_61NvHgGH9ksEFkYqj16NsjVW4dSQu2lIgkGQVy6ueWsx"
      },
      "status": "succeeded",
      "status_details": null,
      "created": "2023-05-12T16:27:02.086Z",
      "receipt_url": "https://payments.stripe.com/transaction_receipt/CCMQARojCiF3a3NwX3Rlc3RfNk8wTVlLWjBTUURuM3A5OG9tZkQwWEEowNT4ogYyBvspfuDuEjpFlCZjXpjpVKRcHPK43kfFldwrwOO8ZPmRHjQmXL1jPf1GWWgoFxtL61dBWz-W2mEzwRgIgC0wPJi7M3HCUIOkSlwyfvHi",
      "status_transitions": {
        "succeeded_at": "2023-05-12T16:27:02.086Z",
        "failed_at": null,
        "returned_at": null
      },
      "livemode": true
    },
    {
      "id": "rc_61NvJ0vCutkwhd9kv16NsjVW3dSQu2lIasGQVy6sdAEq",
      "object": "v2.money_management.received_credit",
      "financial_account": "fa_65NvHabRWMmVKVjernQ16NsjgsfdSQu2lIgkGQVy6ueDtY",
      "amount": {
        "value": 100000000,
        "currency": "usd"
      },
      "description": "Weekly transfer 2",
      "type": "bank_transfer",
      "bank_transfer": {
        "origin_type": "us_bank_account",
        "statement_descriptor": "Fund Stripe account 05/09",
        "us_bank_account": {
          "last4": "4557",
          "routing_number": "011000022",
          "bank_name": "Goldman Sachs",
          "network": "ach"
        },
        "financial_address": "finaddr_61NvHgGH9ksEFkYqj16NsjVW4dSQu2lIgkGQVy6ueWsx"
      },
      "status": "succeeded",
      "status_details": null,
      "created": "2023-05-09T16:27:02.086Z",
      "receipt_url": "https://payments.stripe.com/transaction_receipt/CCMQARojCiF3a3NwX3Rlc3RfNk8wTVlLWjBTUURuM3A5OG9tZkQwWEEowNT4ogYyBiOaJJNGOjpFlA46et0qfvfYTzz0191oHra4Wpa5K80tLvWbiq3egozdIXbUTF95Ot0b5mwx6cf8iCmz28lFtP_Lo3X6MBS_B26m3aCj",
      "status_transitions": {
        "succeeded_at": "2023-05-09T16:27:02.086Z",
        "failed_at": null,
        "returned_at": null
      },
      "livemode": true
    }
  ],
  "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 ReceivedCredit objects v2

Parameters

createdtimestamp

created_gttimestamp

created_gtetimestamp

created_lttimestamp

created_ltetimestamp

limitinteger

pagestring

Returns

Response attributes

dataarray of objects

data.idstring

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

data.amountobject

data.amount.currencystring

data.amount.valueinteger

data.balance_transfernullable object

data.balance_transfer.from_accountnullable string

data.balance_transfer.outbound_paymentnullable string

data.balance_transfer.outbound_transfernullable string

data.balance_transfer.payout_v1nullable string

data.balance_transfer.typeenum

data.bank_transfernullable object

data.bank_transfer.financial_addressstring

data.bank_transfer.gb_bank_accountnullable object

data.bank_transfer.gb_bank_account.account_holder_namenullable string

data.bank_transfer.gb_bank_account.bank_namenullable string

data.bank_transfer.gb_bank_account.last4nullable string

data.bank_transfer.gb_bank_account.networkenum

data.bank_transfer.gb_bank_account.sort_codenullable string

data.bank_transfer.origin_typeenum

data.bank_transfer.sepa_bank_accountnullable object

data.bank_transfer.sepa_bank_account.account_holder_namenullable string

data.bank_transfer.sepa_bank_account.bank_namenullable string

data.bank_transfer.sepa_bank_account.bicnullable string

data.bank_transfer.sepa_bank_account.countrynullable enum

data.bank_transfer.sepa_bank_account.ibannullable string

data.bank_transfer.sepa_bank_account.networkenum

data.bank_transfer.statement_descriptornullable string

data.bank_transfer.us_bank_accountnullable object

data.bank_transfer.us_bank_account.bank_namenullable string

data.bank_transfer.us_bank_account.last4nullable string

data.bank_transfer.us_bank_account.networkenum

data.bank_transfer.us_bank_account.routing_numbernullable string

data.createdtimestamp

data.descriptionnullable string

data.financial_accountstring

data.livemodeboolean

data.receipt_urlnullable string

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.failed_atnullable timestamp

data.status_transitions.returned_atnullable timestamp

data.status_transitions.succeeded_atnullable timestamp

data.typeenum

next_page_urlnullable string

previous_page_urlnullable string