Transfer

transferList

POST
/transfer/list

Use the /transfer/list endpoint to see a list of all your transfers and their statuses. Results are paginated; use the count and offset query parameters to retrieve the desired transfers.

Authorization

PLAID-CLIENT-ID PLAID-SECRET Plaid-Version
PLAID-CLIENT-ID<token>

In: header

PLAID-SECRET<token>

In: header

Plaid-Version<token>

In: header

Request Body

application/json

Defines the request schema for /transfer/list

client_id?string

Your Plaid API client_id. The client_id is required and may be provided either in the PLAID-CLIENT-ID header or as part of a request body.

secret?string

Your Plaid API secret. The secret is required and may be provided either in the PLAID-SECRET header or as part of a request body.

start_date?|

The start datetime of transfers to list. This should be in RFC 3339 format (i.e. 2019-12-06T22:35:49Z)

Formatdate-time
end_date?|

The end datetime of transfers to list. This should be in RFC 3339 format (i.e. 2019-12-06T22:35:49Z)

Formatdate-time
count?integer

The maximum number of transfers to return.

Formatint32
Range1 <= value <= 25
Default25
offset?integer

The number of transfers to skip before returning results.

Formatint32
Range0 <= value
Default0
origination_account_id?|

Filter transfers to only those originated through the specified origination account.

Response Body

application/json

application/json

curl -X POST "https://example.com/transfer/list" \  -H "Content-Type: application/json" \  -d '{}'
{  "transfers": [    {      "account_id": "6qL6lWoQkAfNE3mB8Kk5tAnvpX81qefrvvl7B",      "ach_class": "ppd",      "amount": "12.34",      "cancellable": true,      "created": "2020-08-06T17:27:15Z",      "description": "Testing2",      "failure_reason": {        "ach_return_code": "R13",        "description": "Invalid ACH routing number"      },      "id": "460cbe92-2dcc-8eae-5ad6-b37d0ec90fd9",      "metadata": {        "key1": "value1",        "key2": "value2"      },      "network": "ach",      "origination_account_id": "11111111-1111-1111-1111-111111111111",      "status": "pending",      "type": "credit",      "user": {        "email_address": "plaid@plaid.com",        "legal_name": "John Smith",        "phone_number": null,        "address": null      }    }  ],  "request_id": "saKrIBuEB9qJZno"}