List all transfers

Returns a list of existing transfers sent to connected accounts. The transfers are returned in sorted order, with the most recently created transfers appearing first.

Parameters

destinationstring
Only return transfers for the destination specified by this account ID.

More parameters

createdobject

ending_beforestring

limitinteger

starting_afterstring

transfer_groupstring

Returns

A dictionary with a data property that contains an array of up to limit transfers, starting after transfer starting_after. Each entry in the array is a separate transfer object. If no more transfers are available, the resulting array will be empty.

GET /v1/transfers

Server-side language

curl -G https://api.stripe.com/v1/transfers \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d limit=3

Response

{
  "object": "list",
  "url": "/v1/transfers",
  "has_more": false,
  "data": [
    {
      "id": "tr_1MiN3gLkdIwHu7ixNCZvFdgA",
      "object": "transfer",
      "amount": 400,
      "amount_reversed": 0,
      "balance_transaction": "txn_1MiN3gLkdIwHu7ixxapQrznl",
      "created": 1678043844,
      "currency": "usd",
      "description": null,
      "destination": "acct_1MTfjCQ9PRzxEwkZ",
      "destination_payment": "py_1MiN3gQ9PRzxEwkZWTPGNq9o",
      "livemode": false,
      "metadata": {},
      "reversals": {
        "object": "list",
        "data": [],
        "has_more": false,
        "total_count": 0,
        "url": "/v1/transfers/tr_1MiN3gLkdIwHu7ixNCZvFdgA/reversals"
      },
      "reversed": false,
      "source_transaction": null,
      "source_type": "card",
      "transfer_group": "ORDER_95"
    }
  ]
}

Transfer Reversals

Stripe Connect platforms can reverse transfers made to a connected account, either entirely or partially, and can also specify whether to refund any related application fees. Transfer reversals add to the platform’s balance and subtract from the destination account’s balance.

Reversing a transfer that was made for a destination charge is allowed only up to the amount of the charge. It is possible to reverse a transfer_group transfer only if the destination account has enough balance to cover the reversal.

Related guide: Reverse transfers

Endpoints

POST/v1/transfers/:id/reversals

POST/v1/transfers/:id/reversals/:id

GET/v1/transfers/:id/reversals/:id

GET/v1/transfers/:id/reversals

Secrets

Secret Store is an API that allows Stripe Apps developers to securely persist secrets for use by UI Extensions and app backends.

The primary resource in Secret Store is a secret. Other apps can’t view secrets created by an app. Additionally, secrets are scoped to provide further permission control.

All Dashboard users and the app backend share account scoped secrets. Use the account scope for secrets that don’t change per-user, like a third-party API key.

A user scoped secret is accessible by the app backend and one specific Dashboard user. Use the user scope for per-user secrets like per-user OAuth tokens, where different users might have different permissions.

Related guide: Store data between page reloads

Endpoints

GET/v1/apps/secrets

POST/v1/apps/secrets/delete

GET/v1/apps/secrets/find

POST/v1/apps/secrets

Reserves

Reserves allow Connect platforms who own liability for negative balances to hold a portion of a connected account’s funds to cover refunds and disputes and reduce loss exposure. The Reserves feature is part of the Radar for Platforms product which is currently in private preview. See this page to request early access.