Sample - Plaid API
POST/watchlist_screening/individual/list

List individual watchlist screenings

Lists previously created individual watchlist screenings. Use watchlist_program_id to scope the results, and optionally filter by client_user_id, status, or assignee while using cursor for pagination.

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

7 body fields

Optional filters, pagination information, and authentication credentials for listing individual watchlist screenings.

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.
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.
watchlist_program_idstringrequired
ID of the associated program.
client_user_idstringoptional
A unique ID that identifies the end user in your system. Either a `user_id` or the `client_user_id` must be provided. This ID can also be used to associate user-specific data from other Plaid products. Financial Account Matching requires this field and the `/link/token/create` `client_user_id` to be consistent. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`.
statusstringoptional
A status enum indicating whether a screening is still pending review, has been rejected, or has been cleared.
Allowed:rejectedpending_reviewcleared
assigneestringoptional
ID of the associated user. To retrieve the email address or other details of the person corresponding to this ID, use `/dashboard_user/get`.
cursorstringoptional
An identifier that determines which page of results you receive.

1 status code
200Returns a page of individual screenings in `watchlist_screenings`, along with `next_cursor` and a request identifier.
watchlist_screeningsarray<WatchlistScreeningIndividual>required
List of individual watchlist screenings
next_cursorstringrequired
An identifier that determines which page of results you receive.
request_idstringrequired
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

Error handling

watchlist_program_id must identify the program whose screenings you want to list. status must be rejected, pending_review, or cleared when provided, and cursor should contain a pagination cursor returned by a previous response.