plaid

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.

post/watchlist_screening/entity/history/list

Request body

secretstring

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_idstring

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.

entity_watchlist_screening_idstring required

ID of the associated entity screening.

cursorstring nullable

An identifier that determines which page of results you receive.

Example request

{
  "entity_watchlist_screening_id": "entscr_52xR9LKo77r1Np",
  "cursor": "eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM"
}

Response

next_cursorstring nullable required

An identifier that determines which page of results you receive.

request_idstring required

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

Example response

{
  "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": {
        "dashboard_user_id": "54350110fedcbaf01234ffee",
        "timestamp": "2020-07-24T03:26:02Z"
      }
    }
  ],
  "next_cursor": "eyJkaXJlY3Rpb24iOiJuZXh0Iiwib2Zmc2V0IjoiMTU5NDM"
}

Changes

Changed in 2 of the 52 revisions of this API.41

Jul 22, 2026a1bbca0181601See the full diff
- ●
  added the new retro enum value to the entity_watchlist_screenings/items/audit_trail/source response property for the response status 200
  response-property-enum-value-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 18, 2024be701ec931614See the full diff
- ▲
  the entity_watchlist_screenings/items/client_user_id response property's minLength was decreased from 1 to 0 for the response status 200
  response-property-min-length-decreased
- ▲
  the entity_watchlist_screenings/items/search_terms/country response property's minLength was decreased from 2 to 0 for the response status 200
  response-property-min-length-decreased
- ▲
  the entity_watchlist_screenings/items/search_terms/document_number response property's minLength was decreased from 4 to 0 for the response status 200
  response-property-min-length-decreased
- ▲
  the entity_watchlist_screenings/items/search_terms/legal_name response property's minLength was decreased from 1 to 0 for the response status 200
  response-property-min-length-decreased

Full history