---
title: "Initiate a new Watchlist Verification"
method: POST
path: "/verifications/watchlists"
tags: ["Watchlist Verification"]
---

# Initiate a new Watchlist Verification

`POST /verifications/watchlists`

Initiate a verification to check if a person appears on international sanctions lists or as a politically exposed person (PEP).

## Request body

- InitiateWatchlist
  - `workspace_id` string, uuid, nullable — Scopes the verification to a specific workspace. Defaults to the default workspace if not specified.
  - `natural_person` InitiateWatchlistNaturalPerson, required — Information about the person to check
    - `first_name` string, required — First name of the person
    - `last_name` string, required — Last name of the person
    - `born_on` string, date, required — Date of birth of the person (YYYY-MM-DD)
  - `workflow_session_id` string, uuid, nullable — Unique identifier of a Workflow Session. When provided, an Action is created in the Workflow Session, and this resource is associated with that Action.
  - `previous_attempt_id` string, uuid, nullable — ID of the previous attempt within the same `workflow_session_id`. Allows continuity between multiple attempts of the same Action. Null if this is the first attempt.

## Response `201`

Created

- WatchlistFull
  - `id` string, uuid, required — The unique identifier for a resource.
  - `workspace_id` string, uuid, required — The Workspace ID in which the verification has been created.
  - `created_at` string, date-time, required — Creation date of the Watchlist Verification.
  - `updated_at` string, date-time, required — Update date of the Watchlist Verification.
  - `status` 'pending' | 'verified' | 'failed' | 'inconclusive', required — Status of the Watchlist Verification.
  - `data_anonymized` boolean, required — Indicates if the data related to the Watchlist Verification has been anonymized. If set to `true`, the data are removed and most fields will be NULL.
  - `workflow_session_id` string, uuid, nullable, required — Unique identifier of a Workflow Session. When provided, an Action is created in the Workflow Session, and this resource is associated with that Action.
  - `previous_attempt_id` string, uuid, nullable, required — ID of the previous attempt within the same `workflow_session_id`. Allows continuity between multiple attempts of the same Action. Null if this is the first attempt.
  - `data` WatchlistFullAllOfData, required — Verification result data
    - `politically_exposed_person` WatchlistFullAllOfDataPoliticallyExposedPerson, required — Information about politically exposed person status
      - `active` boolean, required — Whether the person is currently politically exposed
      - `positions` WatchlistFullAllOfDataPoliticallyExposedPersonPositions[], required
        - `title` string, nullable, required — Title of the political position
        - `active` boolean, required — Whether the person is currently politically exposed
        - `country_code` string, ISO 3166-1 alpha-2, nullable, required — ISO country code where the position is held
        - `started_on` string, nullable, required — Date when the position started
        - `ended_on` string, nullable, required — Date when the position ended − null if ongoing
        - `sources` WatchlistFullAllOfDataPoliticallyExposedPersonSources[], required — Sources of this information
          - `name` string, nullable, required — Name of the source
          - `url` string, nullable, required — URL of the source
    - `sanctions` WatchlistFullAllOfDataSanctions, required — List of sanctions against the person
      - `active` boolean, required — Whether the person is currently sanctioned.
      - `records` WatchlistFullAllOfDataSanctionsRecords[], required
        - `description` string, nullable, required — Description of the sanction
        - `authority` string, nullable, required — Authority that issued the sanction
        - `country_code` string, ISO 3166-1 alpha-2, nullable, required — ISO country code where the sanction is applicable
        - `active` boolean, required — Whether the sanction is currently active
        - `started_on` string, nullable, required — Date when the sanction started
        - `ended_on` string, nullable, required — Date when the sanction ended − null if ongoing
        - `sources` WatchlistFullAllOfDataSanctionsSources[], required — Sources of this information
          - `name` string, nullable, required — Name of the source
          - `url` string, nullable, required — URL of the source

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `405` — This method is not allowed
- `415` — UnsupportedMediaType
- `429` — Too Many Requests, please try again later.
- `500` — Internal Server Error

---

[API](https://skmtc.net/yousign/apis/public-api-v3.md) · [All operations](https://skmtc.net/yousign/apis/public-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yousign/public-api-v3/revisions/8d258c0b45d6/schema)