---
title: "Create a review for an entity watchlist screening"
method: POST
path: "/watchlist_screening/entity/review/create"
tags: ["plaid"]
---

# Create a review for an entity watchlist screening

`POST /watchlist_screening/entity/review/create`

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.

## Request body

- WatchlistScreeningEntityReviewCreateRequest — Request input for creating a review for an entity screening
  - `confirmed_hits` EntityWatchlistScreeningHitID[], required — Hits to mark as a true positive after thorough manual review. These hits will never recur or be updated once confirmed. In most cases, confirmed hits indicate that the customer should be rejected.
  - `dismissed_hits` EntityWatchlistScreeningHitID[], required — Hits to mark as a false positive after thorough manual review. These hits will never recur or be updated once dismissed.
  - `comment` string, nullable — A comment submitted by a team member as part of reviewing a watchlist screening.
  - `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.
  - `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.
  - `entity_watchlist_screening_id` string, required — ID of the associated entity screening.

## Response `200`

OK

- WatchlistScreeningEntityReviewCreateResponse — A review submitted by a team member for an entity watchlist screening. A review can be either a comment on the current screening state, actions taken against hits attached to the watchlist screening, or both.
  - `id` string, required — ID of the associated entity review.
  - `confirmed_hits` EntityWatchlistScreeningHitID[], required — Hits marked as a true positive after thorough manual review. These hits will never recur or be updated once confirmed. In most cases, confirmed hits indicate that the customer should be rejected.
  - `dismissed_hits` EntityWatchlistScreeningHitID[], required — Hits marked as a false positive after thorough manual review. These hits will never recur or be updated once dismissed.
  - `comment` string, nullable, required — A comment submitted by a team member as part of reviewing a watchlist screening.
  - `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)