Monitor

requiredobject

Search inputs for creating a watchlist screening

requiredstring

ID of the associated program.

requiredstring

The legal name of the individual being screened.

Min length: 1

string

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

Format: date

string

The numeric or alphanumeric identifier associated with this document.

Min length: 4

string

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

Min length: 2

string

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

string

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.

string

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.

/watchlist_screening/individual/create
Select Language
Copy
1const request: WatchlistScreeningIndividualCreateRequest = {
2  search_terms: {
3    program_id: 'prg_2eRPsDnL66rZ7H',
4    name: 'Aleksey Potemkin',
5    date_of_birth: '1990-05-29',
6    document_number: 'C31195855',
7    country: 'US',
8  },
9  client_user_id: 'example-client-user-id-123',
10};
11
12try {
13  const response = await client.watchlistScreeningIndividualCreate(request);
14} catch (error) {
15  // handle error
16}

watchlist_screening/individual/create

Response fields and example

id

string

ID of the associated screening.

object

Search terms for creating an individual watchlist screening

string

ID of the associated program.

string

The legal name of the individual being screened.

Min length: 1

nullablestring

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

Format: date

nullablestring

The numeric or alphanumeric identifier associated with this document.

Min length: 4

nullablestring

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

Min length: 2

number

The current version of the search terms. Starts at 1 and increments with each edit to search_terms.

nullablestring

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

nullablestring

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

string

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

API Object
Copy
1{
"id": "scr_52xR9LKo77r1Np",
"search_terms": {
  "watchlist_program_id": "prg_2eRPsDnL66rZ7H",
  "legal_name": "Aleksey Potemkin",
  "date_of_birth": "1990-05-29",
  "document_number": "C31195855",
  "country": "US",
  "version": 1
},
"assignee": "54350110fedcbaf01234ffee",
"status": "cleared",
"client_user_id": "your-db-id-3b24110",
"audit_trail": {
  "source": "dashboard",
  "dashboard_user_id": "54350110fedcbaf01234ffee",
  "timestamp": "2020-07-24T03:26:02Z"
},
"request_id": "saKrIBuEB9qJZng"
20}

Was this helpful?

Retrieve an individual watchlist screening

Retrieve a previously created individual watchlist screening

watchlist_screening/individual/get

Request fields and example

requiredstring

ID of the associated screening.

string

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.

string

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_screening/individual/get`
Select Language
Copy
1const request: WatchlistScreeningIndividualGetRequest = {
2  watchlist_screening_id: 'scr_52xR9LKo77r1Np',
3};
4
5try {
6  const response = await client.watchlistScreeningIndividualGet(request);
7} catch (error) {
8  // handle error
9}

watchlist_screening/individual/get

Response fields and example

id

string

ID of the associated screening.

object

Search terms for creating an individual watchlist screening

string

ID of the associated program.

string

The legal name of the individual being screened.

Min length: 1

nullablestring

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

Format: date

nullablestring

The numeric or alphanumeric identifier associated with this document.

Min length: 4

nullablestring

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

Min length: 2

number

The current version of the search terms. Starts at 1 and increments with each edit to search_terms.

nullablestring

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

nullablestring

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

string

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

API Object
Copy
1{
"id": "scr_52xR9LKo77r1Np",
"search_terms": {
  "watchlist_program_id": "prg_2eRPsDnL66rZ7H",
  "legal_name": "Aleksey Potemkin",
  "date_of_birth": "1990-05-29",
  "document_number": "C31195855",
  "country": "US",
  "version": 1
},
"assignee": "54350110fedcbaf01234ffee",
"status": "cleared",
"client_user_id": "your-db-id-3b24110",
"audit_trail": {
  "source": "dashboard",
  "dashboard_user_id": "54350110fedcbaf01234ffee",
  "timestamp": "2020-07-24T03:26:02Z"
},
"request_id": "saKrIBuEB9qJZng"
20}

Was this helpful?

List Individual Watchlist Screenings

List previously created watchlist screenings for individuals

watchlist_screening/individual/list

Request fields and example

string

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.

string

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.

requiredstring

ID of the associated program.

string

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

string

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

Possible values: rejected, pending_review, cleared

string

ID of the associated user.

string

An identifier that determines which page of results you receive.

/watchlist_screening/individual/list
Select Language
Copy
1const request: WatchlistScreeningIndividualListRequest = {
2  watchlist_program_id: 'prg_2eRPsDnL66rZ7H',
3  client_user_id: 'example-client-user-id-123',
4};
5
6try {
7  const response = await client.watchlistScreeningIndividualList(request);
8} catch (error) {
9  // handle error
10}

watchlist_screening/individual/list

Response fields and example

watchlist_screenings

[object]

List of individual watchlist screenings

id

string

ID of the associated screening.

object

Search terms for creating an individual watchlist screening

string

ID of the associated program.

string

The legal name of the individual being screened.

Min length: 1

nullablestring

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

Format: date

nullablestring

The numeric or alphanumeric identifier associated with this document.

Min length: 4

nullablestring

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

Min length: 2

number

The current version of the search terms. Starts at 1 and increments with each edit to search_terms.

nullablestring

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

nullablestring

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

nullablestring

An identifier that determines which page of results you receive.

string

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

API Object
Copy
1{
"watchlist_screenings": [
  {
    "id": "scr_52xR9LKo77r1Np",
    "search_terms": {
      "watchlist_program_id": "prg_2eRPsDnL66rZ7H",
      "legal_name": "Aleksey Potemkin",
      "date_of_birth": "1990-05-29",
      "document_number": "C31195855",
      "country": "US",
      "version": 1
    },
    "assignee": "54350110fedcbaf01234ffee",
    "status": "cleared",
    "client_user_id": "your-db-id-3b24110",
    "audit_trail": {
      "source": "dashboard",
      "dashboard_user_id": "54350110fedcbaf01234ffee",
      "timestamp": "2020-07-24T03:26:02Z"
    }
  }
],
"next_cursor": "eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM",
"request_id": "saKrIBuEB9qJZng"
25}

Was this helpful?

Update individual watchlist screening

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.

watchlist_screening/individual/update

Request fields and example

requiredstring

ID of the associated screening.

object

Search terms for editing an individual watchlist screening

string

ID of the associated program.

string

The legal name of the individual being screened.

Min length: 1

string

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

Format: date

string

The numeric or alphanumeric identifier associated with this document.

Min length: 4

string

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

Min length: 2

string

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

string

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

string

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.

string

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

[string]

A list of fields to reset back to null

Possible values: assignee

/watchlist_screening/individual/update
Select Language
Copy
1const request: WatchlistScreeningIndividualUpdateRequest = {
2  watchlist_screening_id: 'scr_52xR9LKo77r1Np',
3  status: 'cleared',
4};
5
6try {
7  const response = await client.watchlistScreeningIndividualUpdate(request);
8} catch (error) {
9  // handle error
10}

watchlist_screening/individual/update

Response fields and example

id

string

ID of the associated screening.

object

Search terms for creating an individual watchlist screening

string

ID of the associated program.

string

The legal name of the individual being screened.

Min length: 1

nullablestring

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

Format: date

nullablestring

The numeric or alphanumeric identifier associated with this document.

Min length: 4

nullablestring

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

Min length: 2

number

The current version of the search terms. Starts at 1 and increments with each edit to search_terms.

nullablestring

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

nullablestring

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

string

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

API Object
Copy
1{
"id": "scr_52xR9LKo77r1Np",
"search_terms": {
  "watchlist_program_id": "prg_2eRPsDnL66rZ7H",
  "legal_name": "Aleksey Potemkin",
  "date_of_birth": "1990-05-29",
  "document_number": "C31195855",
  "country": "US",
  "version": 1
},
"assignee": "54350110fedcbaf01234ffee",
"status": "cleared",
"client_user_id": "your-db-id-3b24110",
"audit_trail": {
  "source": "dashboard",
  "dashboard_user_id": "54350110fedcbaf01234ffee",
  "timestamp": "2020-07-24T03:26:02Z"
},
"request_id": "saKrIBuEB9qJZng"
20}

Was this helpful?

List history for individual watchlist screenings

List all changes to the individual watchlist screening in reverse-chronological order. If the watchlist screening has not been edited, no history will be returned.

watchlist_screening/individual/history/list

Request fields and example

string

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.

string

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.

requiredstring

ID of the associated screening.

string

An identifier that determines which page of results you receive.

/watchlist_screening/individual/history/list
Select Language
Copy
1const request: WatchlistScreeningIndividualHistoryListRequest = {
2  watchlist_screening_id: 'scr_52xR9LKo77r1Np',
3};
4
5try {
6  const response = await client.watchlistScreeningIndividualHistoryList(
7    request,
8  );
9} catch (error) {
10  // handle error
11}

watchlist_screening/individual/history/list

Response fields and example

watchlist_screenings

[object]

List of individual watchlist screenings

id

string

ID of the associated screening.

object

Search terms for creating an individual watchlist screening

string

ID of the associated program.

string

The legal name of the individual being screened.

Min length: 1

nullablestring

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

Format: date

nullablestring

The numeric or alphanumeric identifier associated with this document.

Min length: 4

nullablestring

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

Min length: 2

number

The current version of the search terms. Starts at 1 and increments with each edit to search_terms.

nullablestring

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

nullablestring

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

nullablestring

An identifier that determines which page of results you receive.

string

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

API Object
Copy
1{
"watchlist_screenings": [
  {
    "id": "scr_52xR9LKo77r1Np",
    "search_terms": {
      "watchlist_program_id": "prg_2eRPsDnL66rZ7H",
      "legal_name": "Aleksey Potemkin",
      "date_of_birth": "1990-05-29",
      "document_number": "C31195855",
      "country": "US",
      "version": 1
    },
    "assignee": "54350110fedcbaf01234ffee",
    "status": "cleared",
    "client_user_id": "your-db-id-3b24110",
    "audit_trail": {
      "source": "dashboard",
      "dashboard_user_id": "54350110fedcbaf01234ffee",
      "timestamp": "2020-07-24T03:26:02Z"
    }
  }
],
"next_cursor": "eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM",
"request_id": "saKrIBuEB9qJZng"
25}

Was this helpful?

Create a review for an individual watchlist screening

Create a review for the individual watchlist screening. Reviews are compliance reports created by users in your organization regarding the relevance of potential hits found by Plaid.

watchlist_screening/individual/review/create

Request fields and example

required[string]

Hits to mark as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected.

required[string]

Hits to mark as a false positive after thorough manual review. These hits will never recur or be updated once dismissed.

string

A comment submitted by a team member as part of reviewing a watchlist screening.

Min length: 1

string

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.

string

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.

requiredstring

ID of the associated screening.

/watchlist_screening/individual/review/create
Select Language
Copy
1const request: WatchlistScreeningIndividualReviewCreateRequest = {
2  confirmed_hits: ['scrhit_52xR9LKo77r1Np'],
3  dismissed_hits: [],
4  watchlist_screening_id: 'scr_52xR9LKo77r1Np',
5};
6
7try {
8  const response = await client.watchlistScreeningIndividualReviewCreate(
9    request,
10  );
11} catch (error) {
12  // handle error
13}

watchlist_screening/individual/review/create

Response fields and example

id

string

ID of the associated review.

[string]

Hits marked as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected.

[string]

Hits marked as a false positive after thorough manual review. These hits will never recur or be updated once dismissed.

nullablestring

A comment submitted by a team member as part of reviewing a watchlist screening.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

string

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

API Object
Copy
1{
"id": "rev_aCLNRxK3UVzn2r",
"confirmed_hits": [
  "scrhit_52xR9LKo77r1Np"
],
"dismissed_hits": [
  "scrhit_52xR9LKo77r1Np"
],
"comment": "These look like legitimate matches, rejecting the customer.",
"audit_trail": {
  "source": "dashboard",
  "dashboard_user_id": "54350110fedcbaf01234ffee",
  "timestamp": "2020-07-24T03:26:02Z"
},
"request_id": "saKrIBuEB9qJZng"
16}

Was this helpful?

List reviews for individual watchlist screenings

List all reviews for the individual watchlist screening.

watchlist_screening/individual/review/list

Request fields and example

string

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.

string

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.

requiredstring

ID of the associated screening.

watchlist_screening_reviews

string

An identifier that determines which page of results you receive.

/watchlist_screening/individual/review/list
Select Language
Copy
1const request: WatchlistScreeningIndividualReviewListRequest = {
2  watchlist_screening_id: 'scr_52xR9LKo77r1Np',
3};
4
5try {
6  const response = await client.watchlistScreeningIndividualReviewList(request);
7} catch (error) {
8  // handle error
9}

watchlist_screening/individual/review/list

Response fields and example

[object]

List of screening reviews

id

string

ID of the associated review.

[string]

Hits marked as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected.

[string]

Hits marked as a false positive after thorough manual review. These hits will never recur or be updated once dismissed.

nullablestring

A comment submitted by a team member as part of reviewing a watchlist screening.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

nullablestring

An identifier that determines which page of results you receive.

string

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

API Object
Copy
1{
"watchlist_screening_reviews": [
  {
    "id": "rev_aCLNRxK3UVzn2r",
    "confirmed_hits": [
      "scrhit_52xR9LKo77r1Np"
    ],
    "dismissed_hits": [
      "scrhit_52xR9LKo77r1Np"
    ],
    "comment": "These look like legitimate matches, rejecting the customer.",
    "audit_trail": {
      "source": "dashboard",
      "dashboard_user_id": "54350110fedcbaf01234ffee",
      "timestamp": "2020-07-24T03:26:02Z"
    }
  }
],
"next_cursor": "eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM",
"request_id": "saKrIBuEB9qJZng"
21}

Was this helpful?

List hits for individual watchlist screening

List all hits found by Plaid for a particular individual watchlist screening.

watchlist_screening/individual/hit/list

Request fields and example

string

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.

string

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.

requiredstring

ID of the associated screening.

watchlist_screening_hits

string

An identifier that determines which page of results you receive.

/watchlist_screening/individual/hit/list
Select Language
Copy
1const request: WatchlistScreeningIndividualHitListRequest = {
2  watchlist_screening_id: 'scr_52xR9LKo77r1Np',
3};
4
5try {
6  const response = await client.watchlistScreeningIndividualHitList(request);
7} catch (error) {
8  // handle error
9}

watchlist_screening/individual/hit/list

Response fields and example

[object]

List of individual watchlist screening hits

id

string

ID of the associated screening hit.

review_status

string

The current state of review. All watchlist screening hits begin in a pending_review state but can be changed by creating a review. When a hit is in the pending_review state, it will always show the latest version of the watchlist data Plaid has available and be compared against the latest customer information saved in the watchlist screening. Once a hit has been marked as confirmed or dismissed it will no longer be updated so that the state is as it was when the review was first conducted.

Possible values: confirmed, pending_review, dismissed

first_active

string

An ISO8601 formatted timestamp.

Format: date-time

inactive_since

nullablestring

An ISO8601 formatted timestamp.

Format: date-time

historical_since

nullablestring

An ISO8601 formatted timestamp.

Format: date-time

list_code

string

Shorthand identifier for a specific screening list for individuals.

Possible values: AU_CON, CA_CON, EU_CON, IZ_CIA, IZ_IPL, IZ_PEP, IZ_UNC, IZ_WBK, UK_HMC, US_DPL, US_DTC, US_FBI, US_FSE, US_ISN, US_MBS, US_PLC, US_SDN, US_SSI, SG_SOF, TR_TWL, TR_DFD, TR_FOR, TR_WMD, TR_CMB

plaid_uid

string

A universal identifier for a watchlist individual that is stable across searches and updates.

source_uid

nullablestring

The identifier provided by the source sanction or watchlist. When one is not provided by the source, this is null.

Min length: 1

object

Analysis information describing why a screening hit matched the provided user information

dates_of_birth

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

locations

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

names

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

search_terms_version

number

The version of the screening's search_terms that were compared when the screening hit was added. screening hits are immutable once they have been reviewed. If changes are detected due to updates to the screening's search_terms, the associated program, or the list's source data prior to review, the screening hit will be updated to reflect those changes.

data

object

Information associated with the watchlist hit

dates_of_birth

[object]

Dates of birth associated with the watchlist hit

object

Summary object reflecting the match result of the associated data

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

data

object

A date range with a start and end date

beginning

string

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

Format: date

ending

string

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

Format: date

[object]

Documents associated with the watchlist hit

object

Summary object reflecting the match result of the associated data

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

data

object

An official document, usually issued by a governing body or institution, with an associated identifier.

type

string

The kind of official document represented by this object.
birth_certificate - A certificate of birth
drivers_license - A license to operate a motor vehicle
immigration_number - Immigration or residence documents
military_id - Identification issued by a military group
other - Any document not covered by other categories
passport - An official passport issue by a government
personal_identification - Any generic personal identification that is not covered by other categories
ration_card - Identification that entitles the holder to rations
ssn - United States Social Security Number
student_id - Identification issued by an educational institution
tax_id - Identification issued for the purpose of collecting taxes
travel_document - Visas, entry permits, refugee documents, etc.
voter_id - Identification issued for the purpose of voting

Possible values: birth_certificate, drivers_license, immigration_number, military_id, other, passport, personal_identification, ration_card, ssn, student_id, tax_id, travel_document, voter_id

number

string

The numeric or alphanumeric identifier associated with this document.

Min length: 4

locations

[object]

Locations associated with the watchlist hit

object

Summary object reflecting the match result of the associated data

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

data

object

Location information for the associated individual watchlist hit

full

string

The full location string, potentially including elements like street, city, postal codes and country codes. Note that this is not necessarily a complete or well-formatted address.

string

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

Min length: 2

names

[object]

Names associated with the watchlist hit

object

Summary object reflecting the match result of the associated data

weak_alias_determination

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

data

object

Name information for the associated individual watchlist hit

full

string

The full name of the individual, including all parts.

is_primary

boolean

Primary names are those most commonly used to refer to this person. Only one name will ever be marked as primary.

string

Names that are explicitly marked as low quality either by their source list, or by plaid by a series of additional checks done by Plaid. Plaid does not ever surface a hit as a result of a weak name alone. If a name has no quality issues, this value will be none.

Possible values: none, source, plaid

nullablestring

An identifier that determines which page of results you receive.

string

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

API Object
Copy
1{
"watchlist_screening_hits": [
  {
    "id": "scrhit_52xR9LKo77r1Np",
    "review_status": "pending_review",
    "first_active": "2020-07-24T03:26:02Z",
    "inactive_since": "2020-07-24T03:26:02Z",
    "historical_since": "2020-07-24T03:26:02Z",
    "list_code": "US_SDN",
    "plaid_uid": "uid_3NggckTimGSJHS",
    "source_uid": "26192ABC",
    "analysis": {
      "dates_of_birth": "match",
      "documents": "match",
      "locations": "match",
      "names": "match",
      "search_terms_version": 1
    },
    "data": {
      "dates_of_birth": [
        {
          "analysis": {
            "summary": "match"
          },
          "data": {
            "beginning": "1990-05-29",
            "ending": "1990-05-29"
          }
        }
      ],
      "documents": [
        {
          "analysis": {
            "summary": "match"
          },
          "data": {
            "type": "passport",
            "number": "C31195855"
          }
        }
      ],
      "locations": [
        {
          "analysis": {
            "summary": "match"
          },
          "data": {
            "full": "Florida, US",
            "country": "US"
          }
        }
      ],
      "names": [
        {
          "analysis": {
            "summary": "match"
          },
          "data": {
            "full": "Aleksey Potemkin",
            "is_primary": false,
            "weak_alias_determination": "none"
          }
        }
      ]
    }
  }
],
"next_cursor": "eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM",
"request_id": "saKrIBuEB9qJZng"
70}

Was this helpful?

Get individual watchlist screening program

Get an individual watchlist screening program

watchlist_screening/individual/program/get

Request fields and example

requiredstring

ID of the associated program.

string

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.

string

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_screening/individual/program/get
Select Language
Copy
1const request: WatchlistScreeningIndividualProgramGetRequest = {
2  watchlist_program_id: 'prg_2eRPsDnL66rZ7H',
3};
4
5try {
6  const response = await client.watchlistScreeningIndividualProgramGet(request);
7} catch (error) {
8  // handle error
9}

watchlist_screening/individual/program/get

Response fields and example

id

string

ID of the associated program.

created_at

string

An ISO8601 formatted timestamp.

Format: date-time

is_rescanning_enabled

boolean

Indicator specifying whether the program is enabled and will perform daily rescans.

lists_enabled

[string]

Watchlists enabled for the associated program

Possible values: AU_CON, CA_CON, EU_CON, IZ_CIA, IZ_IPL, IZ_PEP, IZ_UNC, IZ_WBK, UK_HMC, US_DPL, US_DTC, US_FBI, US_FSE, US_ISN, US_MBS, US_PLC, US_SDN, US_SSI, SG_SOF, TR_TWL, TR_DFD, TR_FOR, TR_WMD, TR_CMB

name

string

A name for the program to define its purpose. For example, "High Risk Individuals", "US Cardholders", or "Applicants".

Min length: 1

name_sensitivity

string

The valid name matching sensitivity configurations for a screening program. Note that while certain matching techniques may be more prevalent on less strict settings, all matching algorithms are enabled for every sensitivity.
coarse - See more potential matches. This sensitivity will see more broad phonetic matches across alphabets that make missing a potential hit very unlikely. This setting is noisier and will require more manual review.
balanced - A good default for most companies. This sensitivity is balanced to show high quality hits with reduced noise.
strict - Aggressive false positive reduction. This sensitivity will require names to be more similar than coarse and balanced settings, relying less on phonetics, while still accounting for character transpositions, missing tokens, and other common permutations.
exact - Matches must be nearly exact. This sensitivity will only show hits with exact or nearly exact name matches with only basic correction such as extraneous symbols and capitalization. This setting is generally not recommended unless you have a very specific use case.

Possible values: coarse, balanced, strict, exact

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

is_archived

boolean

Archived programs are read-only and cannot screen new customers nor participate in ongoing monitoring.

string

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

API Object
Copy
1{
"id": "prg_2eRPsDnL66rZ7H",
"created_at": "2020-07-24T03:26:02Z",
"is_rescanning_enabled": true,
"lists_enabled": [
  "US_SDN"
],
"name": "Sample Program",
"name_sensitivity": "balanced",
"audit_trail": {
  "source": "dashboard",
  "dashboard_user_id": "54350110fedcbaf01234ffee",
  "timestamp": "2020-07-24T03:26:02Z"
},
"is_archived": false,
"request_id": "saKrIBuEB9qJZng"
17}

Was this helpful?

List individual watchlist screening programs

List all individual watchlist screening programs

watchlist_screening/individual/program/list

Request fields and example

string

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.

string

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.

string

An identifier that determines which page of results you receive.

/watchlist_screening/individual/program/list
Select Language
Copy
1try {
2  const response = await client.watchlistScreeningIndividualProgramList({});
3} catch (error) {
4  // handle error
5}

watchlist_screening/individual/program/list

Response fields and example

watchlist_programs

[object]

List of individual watchlist screening programs

id

string

ID of the associated program.

created_at

string

An ISO8601 formatted timestamp.

Format: date-time

is_rescanning_enabled

boolean

Indicator specifying whether the program is enabled and will perform daily rescans.

lists_enabled

[string]

Watchlists enabled for the associated program

Possible values: AU_CON, CA_CON, EU_CON, IZ_CIA, IZ_IPL, IZ_PEP, IZ_UNC, IZ_WBK, UK_HMC, US_DPL, US_DTC, US_FBI, US_FSE, US_ISN, US_MBS, US_PLC, US_SDN, US_SSI, SG_SOF, TR_TWL, TR_DFD, TR_FOR, TR_WMD, TR_CMB

name

string

A name for the program to define its purpose. For example, "High Risk Individuals", "US Cardholders", or "Applicants".

Min length: 1

name_sensitivity

string

The valid name matching sensitivity configurations for a screening program. Note that while certain matching techniques may be more prevalent on less strict settings, all matching algorithms are enabled for every sensitivity.
coarse - See more potential matches. This sensitivity will see more broad phonetic matches across alphabets that make missing a potential hit very unlikely. This setting is noisier and will require more manual review.
balanced - A good default for most companies. This sensitivity is balanced to show high quality hits with reduced noise.
strict - Aggressive false positive reduction. This sensitivity will require names to be more similar than coarse and balanced settings, relying less on phonetics, while still accounting for character transpositions, missing tokens, and other common permutations.
exact - Matches must be nearly exact. This sensitivity will only show hits with exact or nearly exact name matches with only basic correction such as extraneous symbols and capitalization. This setting is generally not recommended unless you have a very specific use case.

Possible values: coarse, balanced, strict, exact

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

is_archived

boolean

Archived programs are read-only and cannot screen new customers nor participate in ongoing monitoring.

nullablestring

An identifier that determines which page of results you receive.

string

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

API Object
Copy
1{
"watchlist_programs": [
  {
    "id": "prg_2eRPsDnL66rZ7H",
    "created_at": "2020-07-24T03:26:02Z",
    "is_rescanning_enabled": true,
    "lists_enabled": [
      "US_SDN"
    ],
    "name": "Sample Program",
    "name_sensitivity": "balanced",
    "audit_trail": {
      "source": "dashboard",
      "dashboard_user_id": "54350110fedcbaf01234ffee",
      "timestamp": "2020-07-24T03:26:02Z"
    },
    "is_archived": false
  }
],
"next_cursor": "eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM",
"request_id": "saKrIBuEB9qJZng"
22}

Was this helpful?

Create a watchlist screening for an entity

Create a new entity watchlist screening to check your customer against watchlists defined in the associated entity watchlist program. If your associated program has ongoing screening enabled, this is the profile information that will be used to monitor your customer over time.

watchlist_screening/entity/create

Request fields and example

requiredobject

Search inputs for creating an entity watchlist screening

requiredstring

ID of the associated entity program.

requiredstring

The name of the organization being screened.

Min length: 1

string

The numeric or alphanumeric identifier associated with this document.

Min length: 4

string

A valid email address.

Format: email

string

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

Min length: 2

string

A phone number in E.164 format.

url

string

An 'http' or 'https' URL (must begin with either of those).

Format: uri

string

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

string

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.

string

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.

/watchlist_screening/entity/create
Select Language
Copy
1const request: WatchlistScreeningEntityCreateRequest = {
2  search_terms: {
3    entity_watchlist_program_id: 'entprg_2eRPsDnL66rZ7H',
4    name: 'Example Screening Entity',
5    document_number: 'C31195855',
6    email_address: 'user@example.com',
7    country: 'US',
8    phone_number: '+14025671234',
9    url: 'https://example.com',
10  },
11  client_user_id: 'example-client-user-id-123',
12};
13
14try {
15  const response = await client.watchlistScreeningEntityCreate(request);
16} catch (error) {
17  // handle error
18}

watchlist_screening/entity/create

Response fields and example

id

string

ID of the associated entity screening.

object

Search terms associated with an entity used for searching against watchlists

string

ID of the associated entity program.

string

The name of the organization being screened.

Min length: 1

nullablestring

The numeric or alphanumeric identifier associated with this document.

Min length: 4

nullablestring

A valid email address.

Format: email

nullablestring

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

Min length: 2

nullablestring

A phone number in E.164 format.

url

nullablestring

An 'http' or 'https' URL (must begin with either of those).

Format: uri

number

The current version of the search terms. Starts at 1 and increments with each edit to search_terms.

nullablestring

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

nullablestring

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

string

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

API Object
Copy
1{
"id": "entscr_52xR9LKo77r1Np",
"search_terms": {
  "entity_watchlist_program_id": "entprg_2eRPsDnL66rZ7H",
  "legal_name": "Al-Qaida",
  "document_number": "C31195855",
  "email_address": "user@example.com",
  "country": "US",
  "phone_number": "+14025671234",
  "url": "https://example.com",
  "version": 1
},
"assignee": "54350110fedcbaf01234ffee",
"status": "cleared",
"client_user_id": "your-db-id-3b24110",
"audit_trail": {
  "source": "dashboard",
  "dashboard_user_id": "54350110fedcbaf01234ffee",
  "timestamp": "2020-07-24T03:26:02Z"
},
"request_id": "saKrIBuEB9qJZng"
22}

Was this helpful?

Get an entity screening

Retrieve an entity watchlist screening.

watchlist_screening/entity/get

Request fields and example

requiredstring

ID of the associated entity screening.

string

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.

string

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_screening/entity/get
Select Language
Copy
1const request: WatchlistScreeningEntityGetRequest = {
2  entity_watchlist_screening_id: 'entscr_52xR9LKo77r1Np',
3};
4
5try {
6  const response = await client.watchlistScreeningEntityGet(request);
7} catch (error) {
8  // handle error
9}

watchlist_screening/entity/get

Response fields and example

id

string

ID of the associated entity screening.

object

Search terms associated with an entity used for searching against watchlists

string

ID of the associated entity program.

string

The name of the organization being screened.

Min length: 1

nullablestring

The numeric or alphanumeric identifier associated with this document.

Min length: 4

nullablestring

A valid email address.

Format: email

nullablestring

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

Min length: 2

nullablestring

A phone number in E.164 format.

url

nullablestring

An 'http' or 'https' URL (must begin with either of those).

Format: uri

number

The current version of the search terms. Starts at 1 and increments with each edit to search_terms.

nullablestring

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

nullablestring

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

string

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

API Object
Copy
1{
"id": "entscr_52xR9LKo77r1Np",
"search_terms": {
  "entity_watchlist_program_id": "entprg_2eRPsDnL66rZ7H",
  "legal_name": "Al-Qaida",
  "document_number": "C31195855",
  "email_address": "user@example.com",
  "country": "US",
  "phone_number": "+14025671234",
  "url": "https://example.com",
  "version": 1
},
"assignee": "54350110fedcbaf01234ffee",
"status": "cleared",
"client_user_id": "your-db-id-3b24110",
"audit_trail": {
  "source": "dashboard",
  "dashboard_user_id": "54350110fedcbaf01234ffee",
  "timestamp": "2020-07-24T03:26:02Z"
},
"request_id": "saKrIBuEB9qJZng"
22}

Was this helpful?

List entity watchlist screenings

List all entity screenings.

watchlist_screening/entity/list

Request fields and example

string

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.

string

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.

requiredstring

ID of the associated entity program.

string

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

string

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

Possible values: rejected, pending_review, cleared

string

ID of the associated user.

entity_watchlist_screenings

string

An identifier that determines which page of results you receive.

/watchlist_screening/entity/list
Select Language
Copy
1const request: WatchlistScreeningEntityListRequest = {
2  entity_watchlist_program_id: 'entprg_2eRPsDnL66rZ7H',
3};
4
5try {
6  const response = await client.watchlistScreeningEntityList(request);
7} catch (error) {
8  // handle error
9}

watchlist_screening/entity/list

Response fields and example

[object]

List of entity watchlist screening

id

string

ID of the associated entity screening.

object

Search terms associated with an entity used for searching against watchlists

string

ID of the associated entity program.

string

The name of the organization being screened.

Min length: 1

nullablestring

The numeric or alphanumeric identifier associated with this document.

Min length: 4

nullablestring

A valid email address.

Format: email

nullablestring

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

Min length: 2

nullablestring

A phone number in E.164 format.

url

nullablestring

An 'http' or 'https' URL (must begin with either of those).

Format: uri

number

The current version of the search terms. Starts at 1 and increments with each edit to search_terms.

nullablestring

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

nullablestring

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

nullablestring

An identifier that determines which page of results you receive.

string

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

API Object
Copy
1{
"entity_watchlist_screenings": [
  {
    "id": "entscr_52xR9LKo77r1Np",
    "search_terms": {
      "entity_watchlist_program_id": "entprg_2eRPsDnL66rZ7H",
      "legal_name": "Al-Qaida",
      "document_number": "C31195855",
      "email_address": "user@example.com",
      "country": "US",
      "phone_number": "+14025671234",
      "url": "https://example.com",
      "version": 1
    },
    "assignee": "54350110fedcbaf01234ffee",
    "status": "cleared",
    "client_user_id": "your-db-id-3b24110",
    "audit_trail": {
      "source": "dashboard",
      "dashboard_user_id": "54350110fedcbaf01234ffee",
      "timestamp": "2020-07-24T03:26:02Z"
    }
  }
],
"next_cursor": "eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM",
"request_id": "saKrIBuEB9qJZng"
27}

Was this helpful?

Update an entity screening

Update an entity watchlist screening.

watchlist_screening/entity/update

Request fields and example

requiredstring

ID of the associated entity screening.

object

Search terms for editing an entity watchlist screening

requiredstring

ID of the associated entity program.

string

The name of the organization being screened.

Min length: 1

string

The numeric or alphanumeric identifier associated with this document.

Min length: 4

string

A valid email address.

Format: email

string

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

Min length: 2

string

A phone number in E.164 format.

url

string

An 'http' or 'https' URL (must begin with either of those).

Format: uri

requiredstring

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.

requiredstring

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.

string

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

string

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

string

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.

string

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

[string]

A list of fields to reset back to null

Possible values: assignee

/watchlist_screening/entity/update
Select Language
Copy
1const request: WatchlistScreeningEntityUpdateRequest = {
2  entity_watchlist_screening_id: 'entscr_52xR9LKo77r1Np',
3  status: 'cleared',
4};
5
6try {
7  const response = await client.watchlistScreeningEntityUpdate(request);
8} catch (error) {
9  // handle error
10}

watchlist_screening/entity/update

Response fields and example

id

string

ID of the associated entity screening.

object

Search terms associated with an entity used for searching against watchlists

string

ID of the associated entity program.

string

The name of the organization being screened.

Min length: 1

nullablestring

The numeric or alphanumeric identifier associated with this document.

Min length: 4

nullablestring

A valid email address.

Format: email

nullablestring

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

Min length: 2

nullablestring

A phone number in E.164 format.

url

nullablestring

An 'http' or 'https' URL (must begin with either of those).

Format: uri

number

The current version of the search terms. Starts at 1 and increments with each edit to search_terms.

nullablestring

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

nullablestring

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

string

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

API Object
Copy
1{
"id": "entscr_52xR9LKo77r1Np",
"search_terms": {
  "entity_watchlist_program_id": "entprg_2eRPsDnL66rZ7H",
  "legal_name": "Al-Qaida",
  "document_number": "C31195855",
  "email_address": "user@example.com",
  "country": "US",
  "phone_number": "+14025671234",
  "url": "https://example.com",
  "version": 1
},
"assignee": "54350110fedcbaf01234ffee",
"status": "cleared",
"client_user_id": "your-db-id-3b24110",
"audit_trail": {
  "source": "dashboard",
  "dashboard_user_id": "54350110fedcbaf01234ffee",
  "timestamp": "2020-07-24T03:26:02Z"
},
"request_id": "saKrIBuEB9qJZng"
22}

Was this helpful?

List history for entity watchlist screenings

List all changes to the entity watchlist screening in reverse-chronological order. If the watchlist screening has not been edited, no history will be returned.

watchlist_screening/entity/history/list

Request fields and example

string

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.

string

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.

requiredstring

ID of the associated entity screening.

entity_watchlist_screenings

string

An identifier that determines which page of results you receive.

/watchlist_screening/entity/history/list
Select Language
Copy
1const request: WatchlistScreeningEntityHistoryListRequest = {
2  entity_watchlist_screening_id: 'entscr_52xR9LKo77r1Np',
3};
4
5try {
6  const response = await client.watchlistScreeningEntityHistoryList(request);
7} catch (error) {
8  // handle error
9}

watchlist_screening/entity/history/list

Response fields and example

[object]

List of entity watchlist screening

id

string

ID of the associated entity screening.

object

Search terms associated with an entity used for searching against watchlists

string

ID of the associated entity program.

string

The name of the organization being screened.

Min length: 1

nullablestring

The numeric or alphanumeric identifier associated with this document.

Min length: 4

nullablestring

A valid email address.

Format: email

nullablestring

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

Min length: 2

nullablestring

A phone number in E.164 format.

url

nullablestring

An 'http' or 'https' URL (must begin with either of those).

Format: uri

number

The current version of the search terms. Starts at 1 and increments with each edit to search_terms.

nullablestring

ID of the associated user.

string

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

Possible values: rejected, pending_review, cleared

nullablestring

An identifier to help you connect this object to your internal systems. For example, your database ID corresponding to this object.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

nullablestring

An identifier that determines which page of results you receive.

string

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

API Object
Copy
1{
"entity_watchlist_screenings": [
  {
    "id": "entscr_52xR9LKo77r1Np",
    "search_terms": {
      "entity_watchlist_program_id": "entprg_2eRPsDnL66rZ7H",
      "legal_name": "Al-Qaida",
      "document_number": "C31195855",
      "email_address": "user@example.com",
      "country": "US",
      "phone_number": "+14025671234",
      "url": "https://example.com",
      "version": 1
    },
    "assignee": "54350110fedcbaf01234ffee",
    "status": "cleared",
    "client_user_id": "your-db-id-3b24110",
    "audit_trail": {
      "source": "dashboard",
      "dashboard_user_id": "54350110fedcbaf01234ffee",
      "timestamp": "2020-07-24T03:26:02Z"
    }
  }
],
"next_cursor": "eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM",
"request_id": "saKrIBuEB9qJZng"
27}

Was this helpful?

Create a review for an entity watchlist screening

Create a review for an entity watchlist screening. Reviews are compliance reports created by users in your organization regarding the relevance of potential hits found by Plaid.

watchlist_screening/entity/review/create

Request fields and example

required[string]

Hits to mark as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected.

required[string]

Hits to mark as a false positive after thorough manual review. These hits will never recur or be updated once dismissed.

string

A comment submitted by a team member as part of reviewing a watchlist screening.

Min length: 1

string

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.

string

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.

requiredstring

ID of the associated entity screening.

/watchlist_screening/entity/review/create
Select Language
Copy
1const request: WatchlistScreeningEntityReviewCreateRequest = {
2  entity_watchlist_screening_id: 'entscr_52xR9LKo77r1Np',
3};
4
5try {
6  const response = await client.watchlistScreeningEntityReviewCreate(request);
7} catch (error) {
8  // handle error
9}

watchlist_screening/entity/review/create

Response fields and example

id

string

ID of the associated entity review.

[string]

Hits marked as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected.

[string]

Hits marked as a false positive after thorough manual review. These hits will never recur or be updated once dismissed.

nullablestring

A comment submitted by a team member as part of reviewing a watchlist screening.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

string

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

API Object
Copy
1{
"id": "entrev_aCLNRxK3UVzn2r",
"confirmed_hits": [
  "enthit_52xR9LKo77r1Np"
],
"dismissed_hits": [
  "enthit_52xR9LKo77r1Np"
],
"comment": "These look like legitimate matches, rejecting the customer.",
"audit_trail": {
  "source": "dashboard",
  "dashboard_user_id": "54350110fedcbaf01234ffee",
  "timestamp": "2020-07-24T03:26:02Z"
},
"request_id": "saKrIBuEB9qJZng"
16}

Was this helpful?

List reviews for entity watchlist screenings

List all reviews for a particular entity watchlist screening. Reviews are compliance reports created by users in your organization regarding the relevance of potential hits found by Plaid.

watchlist_screening/entity/review/list

Request fields and example

string

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.

string

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.

requiredstring

ID of the associated entity screening.

entity_watchlist_screening_reviews

string

An identifier that determines which page of results you receive.

/watchlist_screening/entity/review/list
Select Language
Copy
1const request: WatchlistScreeningEntityReviewListRequest = {
2  entity_watchlist_screening_id: 'entscr_52xR9LKo77r1Np',
3};
4
5try {
6  const response = await client.watchlistScreeningEntityReviewList(request);
7} catch (error) {
8  // handle error
9}

watchlist_screening/entity/review/list

Response fields and example

[object]

List of entity watchlist screening reviews

id

string

ID of the associated entity review.

[string]

Hits marked as a true positive after thorough manual review. These hits will never recur or be updated once dismissed. In most cases, confirmed hits indicate that the customer should be rejected.

[string]

Hits marked as a false positive after thorough manual review. These hits will never recur or be updated once dismissed.

nullablestring

A comment submitted by a team member as part of reviewing a watchlist screening.

Min length: 1

object

Information about the last change made to the parent object specifying what caused the change as well as when it occurred.

string

A type indicating whether a dashboard user, an API-based user, or Plaid last touched this object.

Possible values: dashboard, link, api, system

nullablestring

ID of the associated user.

string

An ISO8601 formatted timestamp.

Format: date-time

nullablestring

An identifier that determines which page of results you receive.

string

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

API Object
Copy
1{
"entity_watchlist_screening_reviews": [
  {
    "id": "entrev_aCLNRxK3UVzn2r",
    "confirmed_hits": [
      "enthit_52xR9LKo77r1Np"
    ],
    "dismissed_hits": [
      "enthit_52xR9LKo77r1Np"
    ],
    "comment": "These look like legitimate matches, rejecting the customer.",
    "audit_trail": {
      "source": "dashboard",
      "dashboard_user_id": "54350110fedcbaf01234ffee",
      "timestamp": "2020-07-24T03:26:02Z"
    }
  }
],
"next_cursor": "eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM",
"request_id": "saKrIBuEB9qJZng"
21}

Was this helpful?

List hits for entity watchlist screenings

List all hits for the entity watchlist screening.

watchlist_screening/entity/hit/list

Request fields and example

string

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.

string

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.

requiredstring

ID of the associated entity screening.

entity_watchlist_screening_hits

string

An identifier that determines which page of results you receive.

/watchlist_screening/entity/hit/list
Select Language
Copy
1const request: WatchlistScreeningEntityHitListRequest = {
2  entity_watchlist_screening_id: 'entscr_52xR9LKo77r1Np',
3};
4
5try {
6  const response = await client.watchlistScreeningEntityHitList(request);
7} catch (error) {
8  // handle error
9}

watchlist_screening/entity/hit/list

Response fields and example

[object]

List of entity watchlist screening hits

id

string

ID of the associated entity screening hit.

review_status

string

The current state of review. All watchlist screening hits begin in a pending_review state but can be changed by creating a review. When a hit is in the pending_review state, it will always show the latest version of the watchlist data Plaid has available and be compared against the latest customer information saved in the watchlist screening. Once a hit has been marked as confirmed or dismissed it will no longer be updated so that the state is as it was when the review was first conducted.

Possible values: confirmed, pending_review, dismissed

first_active

string

An ISO8601 formatted timestamp.

Format: date-time

inactive_since

nullablestring

An ISO8601 formatted timestamp.

Format: date-time

historical_since

nullablestring

An ISO8601 formatted timestamp.

Format: date-time

list_code

string

Shorthand identifier for a specific screening list for entities.

Possible values: CA_CON, EU_CON, IZ_SOE, IZ_UNC, IZ_WBK, US_CAP, US_FSE, US_MBS, US_SDN, US_SSI, US_CMC, US_UVL, AU_CON, UK_HMC

plaid_uid

string

A universal identifier for a watchlist individual that is stable across searches and updates.

source_uid

nullablestring

The identifier provided by the source sanction or watchlist. When one is not provided by the source, this is null.

Min length: 1

object

Analysis information describing why a screening hit matched the provided entity information

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

email_addresses

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

locations

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

names

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

phone_numbers

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

urls

string

An enum indicating the match type between data provided by user and data checked against an external data source.
match indicates that the provided input data was a strong match against external data.
partial_match indicates the data approximately matched against external data. For example, "Knope" vs. "Knope-Wyatt" for last name.
no_match indicates that Plaid was able to perform a check against an external data source and it did not match the provided input data.
no_data indicates that Plaid was unable to find external data to compare against the provided input data.
no_input indicates that Plaid was unable to perform a check because no information was provided for this field by the end user.

Possible values: match, partial_match, no_match, no_data, no_input

search_terms_version

number

The version of the entity screening's search_terms that were compared when the entity screening hit was added. entity screening hits are immutable once they have been reviewed. If changes are detected due to updates to the entity screening's search_terms, the associated entity program, or the list's source data prior to review, the entity screening hit will be updated to reflect those changes.

data

object

Information associated with the entity watchlist hit

[object]

Documents associated with the watchlist hit

object

Summary object reflecting the match result of the associated data