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
- https://production.plaid.com
- https://sandbox.plaid.com
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 |
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 |
status |
String | No |
A status enum indicating whether a screening is still pending review, has been rejected, or has been cleared. Possible values:
|
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 |
secret |
String | No |
Your Plaid API |
reset_fields[] |
Array | No |
A list of fields to reset back to null |
How to start integrating
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.