---
title: "Retrieve an individual watchlist screening"
method: POST
path: "/watchlist_screening/individual/get"
tags: ["plaid"]
---

# Retrieve an individual watchlist screening

`POST /watchlist_screening/individual/get`

Retrieve a previously created individual watchlist screening

## Request body

- WatchlistScreeningIndividualGetRequest — Request input for fetching an individual watchlist screening
  - `watchlist_screening_id` string, required — ID of the associated screening.
  - `secret` 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.
  - `client_id` 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.

## Response `200`

OK

- WatchlistScreeningIndividualGetResponse — The screening object allows you to represent a customer in your system, update their profile, and search for them on various watchlists. Note: Rejected customers will not receive new hits, regardless of program configuration.
  - `id` string, required — ID of the associated screening.
  - `search_terms` WatchlistScreeningSearchTerms, required — Search terms for creating an individual watchlist screening
    - `watchlist_program_id` string, required — ID of the associated program.
    - `legal_name` string, required — 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.
    - `date_of_birth` string, date, nullable, required — A date in the format YYYY-MM-DD (RFC 3339 Section 5.6).
    - `document_number` string, nullable, required — The numeric or alphanumeric identifier associated with this document. Must be between 4 and 32 characters long, and cannot have leading or trailing spaces.
    - `country` string, nullable, required — Valid, capitalized, two-letter ISO code representing the country of this object. Must be in ISO 3166-1 alpha-2 form.
    - `version` integer, required — The current version of the search terms. Starts at `1` and increments with each edit to `search_terms`.
  - `assignee` string, nullable, required — ID of the associated user. To retrieve the email address or other details of the person corresponding to this ID, use `/dashboard_user/get`.
  - `status` 'rejected' | 'pending_review' | 'cleared', required — A status enum indicating whether a screening is still pending review, has been rejected, or has been cleared.
  - `client_user_id` string, nullable, required — 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`.
  - `audit_trail` WatchlistScreeningAuditTrail, required — Information about the last change made to the parent object specifying what caused the change as well as when it occurred.
    - `source` 'dashboard' | 'link' | 'api' | 'system' | 'retro', required — A type indicating who or what last touched this object. `dashboard`, `link`, and `api` indicate the originating surface; `system` indicates Plaid. `retro` indicates a screening created retroactively via a bulk screening creation.
    - `dashboard_user_id` string, nullable, required — ID of the associated user. To retrieve the email address or other details of the person corresponding to this ID, use `/dashboard_user/get`.
    - `timestamp` string, date-time, required — An ISO8601 formatted timestamp.
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

---

[API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/versions/64c4514ea59b/schema)