POST /watchlist_screening/individual/update

Update a specific individual watchlist screening. This endpoint can be used to add additional customer information, correct outdated information, add a reference id, assign the individual to a reviewer, and update which program it is associated with. Please note that you may not update search_terms and status at the same time since editing search_terms may trigger an automatic status change.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
assignee String No

ID of the associated user. To retrieve the email address or other details of the person corresponding to this id, use /dashboard_user/get.

watchlist_screening_id String Yes

ID of the associated screening.

search_terms Object No

Search terms for editing an individual watchlist screening

search_terms.date_of_birth String No

A date in the format YYYY-MM-DD (RFC 3339 Section 5.6).

search_terms.watchlist_program_id String No

ID of the associated program.

search_terms.legal_name String No

The legal name of the individual being screened. Must have at least one alphabetical character, have a maximum length of 100 characters, and not include leading or trailing spaces.

search_terms.document_number String No

The numeric or alphanumeric identifier associated with this document. Must be between 4 and 32 characters long, and cannot have leading or trailing spaces.

search_terms.country String No

Valid, capitalized, two-letter ISO code representing the country of this object. Must be in ISO 3166-1 alpha-2 form.

client_id String No

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.

status String No

A status enum indicating whether a screening is still pending review, has been rejected, or has been cleared.

Possible values:

  • "pending_review"
  • "cleared"
  • "rejected"
client_user_id String No

A unique ID that identifies the end user in your system. 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.

secret String No

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.

reset_fields[] Array No

A list of fields to reset back to null

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.