Sample - Plaid API
POST/transfer/event/list

List transfer events

Lists transfer events using optional date, transfer, account, event-type, sweep, originator, and funding-account filters. Use count and offset to page through the results; when more events match the filters than the selected page, the response indicates that additional events are available.

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

14 body fields

Transfer event filters and pagination settings.

client_idstringoptional
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.
secretstringoptional
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_datestringoptional
The start `created` datetime of transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`)
end_datestringoptional
The end `created` datetime of transfers to list. This should be in RFC 3339 format (i.e. `2019-12-06T22:35:49Z`)
transfer_idstringoptional
Plaid's unique identifier for a transfer.
account_idstringoptional
The account ID to get events for all transactions to/from an account.
transfer_typestringoptional
The type of transfer. This will be either `debit` or `credit`. A `debit` indicates a transfer of money into your origination account; a `credit` indicates a transfer of money out of your origination account.
Allowed:debitcreditnull
event_typesarray<TransferEventType>optional
Filter events by event type.
sweep_idstringoptional
Plaid's unique identifier for a sweep.
countintegeroptional
The maximum number of transfer events to return. If the number of events matching the above parameters is greater than `count`, the most recent events will be returned.
Default:25
offsetintegeroptional
The offset into the list of transfer events. When `count`=25 and `offset`=0, the first 25 events will be returned. When `count`=25 and `offset`=25, the next 25 events will be returned.
Default:0
origination_account_idstringdeprecatedoptional
The origination account ID to get events for transfers from a specific origination account.
originator_client_idstringoptional
Filter transfer events to only those with the specified originator client.
funding_account_idstringoptional
Filter transfer events to only those with the specified `funding_account_id`.

2 status codes
200Returns a paginated array of transfer event objects, a `has_more` indicator, and a request identifier.
transfer_eventsarray<TransferEvent>required
has_morebooleanrequired
Whether there are more events to be pulled from the endpoint that have not already been returned
request_idstringrequired
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.
defaultError response
error_typestringrequired
A broad categorization of the error. Safe for programmatic use.
Allowed:INVALID_REQUESTINVALID_RESULTINVALID_INPUTINSTITUTION_ERRORRATE_LIMIT_EXCEEDEDAPI_ERRORITEM_ERRORASSET_REPORT_ERRORBASE_REPORT_ERRORRECAPTCHA_ERROROAUTH_ERRORPAYMENT_ERROR
error_codestringrequired
The particular error code. Safe for programmatic use.
error_code_reasonstringoptional
The specific reason for the error code. Currently, reasons are only supported for OAuth-based item errors; `null` will be returned otherwise. Safe for programmatic use. Possible values: `OAUTH_INVALID_TOKEN`: The user's OAuth connection to this institution has been invalidated. `OAUTH_CONSENT_EXPIRED`: The user's access consent for this OAuth connection to this institution has expired. `OAUTH_USER_REVOKED`: The user's OAuth connection to this institution is invalid because the user revoked their connection.
error_messagestringrequired
A developer-friendly representation of the error code. This may change over time and is not safe for programmatic use.
display_messagestringrequired
A user-friendly representation of the error code. `null` if the error is not related to user action. This may change over time and is not safe for programmatic use.
request_idstringoptional
A unique ID identifying the request, to be used for troubleshooting purposes. This field will be omitted in errors provided by webhooks.
causesarrayoptional
In this product, a request can pertain to more than one Item. If an error is returned for such a request, `causes` will return an array of errors containing a breakdown of these errors on the individual Item level, if any can be identified. `causes` will be provided for the `error_type` `ASSET_REPORT_ERROR` or `CHECK_REPORT_ERROR`. `causes` will also not be populated inside an error nested within a `warning` object.
statusintegeroptional
The HTTP status code associated with the error. This will only be returned in the response body when the error information is provided via a webhook.
documentation_urlstringoptional
The URL of a Plaid documentation page with more information about the error
suggested_actionstringoptional
Suggested steps for resolving the error
required_account_subtypesarray<string>optional
A list of the account subtypes that were requested via the `account_filters` parameter in `/link/token/create`. Currently only populated for `NO_ACCOUNTS` errors from Items with `investments_auth` as an enabled product.
provided_account_subtypesarray<string>optional
A list of the account subtypes that were extracted but did not match the requested subtypes via the `account_filters` parameter in `/link/token/create`. Currently only populated for `NO_ACCOUNTS` errors from Items with `investments_auth` as an enabled product.

Error handling

count must be between 1 and 25, and offset must be zero or greater. start_date and end_date must use RFC 3339 date-time format when supplied, transfer_type must be debit, credit, or null, and each event_types value must be an allowed event type. client_id and secret may be supplied in the body or through their corresponding headers.