Sign in
plaid

List sweeps

The /transfer/sweep/list endpoint fetches sweeps matching the given filters.

post/transfer/sweep/list

Request body

client_idstring

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.

secretstring

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_datestring date-time nullable

The start datetime of sweeps to return (RFC 3339 format).

end_datestring date-time nullable

The end datetime of sweeps to return (RFC 3339 format).

countinteger nullable

The maximum number of sweeps to return.

offsetinteger

The number of sweeps to skip before returning results.

amountstring nullable

Filter sweeps to only those with the specified amount.

status'pending' | 'posted' | 'settled' | 'returned' | 'failed' | 'null' nullable

The status of a sweep transfer

"pending" - The sweep is currently pending "posted" - The sweep has been posted "settled" - The sweep has settled "returned" - The sweep has been returned "failed" - The sweep has failed

originator_client_idstring nullable

Filter sweeps to only those with the specified originator client.

funding_account_idstring nullable

Filter sweeps to only those with the specified funding_account_id.

transfer_idstring nullable

Filter sweeps to only those with the included transfer_id.

trigger'manual' | 'incoming' | 'balance_threshold' | 'automatic_aggregate' nullable

The trigger of the sweep

"manual" - The sweep is created manually by the customer "incoming" - The sweep is created by incoming funds flow (e.g. Incoming Wire) "balance_threshold" - The sweep is created by balance threshold setting "automatic_aggregate" - The sweep is created by the Plaid automatic aggregation process. These funds did not pass through the Plaid Ledger balance.

Response

OK

request_idstring required

A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

Changes