Sign in

v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-313352,3122.9 MB
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 created datetime of sweeps to return (RFC 3339 format).

end_datestring date-time nullable

The end created 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' | 'funds_available' | '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. This is the terminal state of a successful credit sweep. "returned" - The sweep has been returned. This is the terminal state of a returned sweep. Returns of a sweep are extremely rare, since sweeps are money movement between your own bank account and your own Ledger. "funds_available" - Funds from the sweep have been released from hold and applied to the ledger's available balance. (Only applicable to deposits.) This is the terminal state of a successful deposit sweep. "failed" - The sweep has failed. This is the terminal state of a failed sweep.

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.