Get watchlist verification results via Webhooks

Webhooks provide an efficient way to get notified when a watchlist verification has been completed, and to retrieve the related verification results.
For more details on setting up and managing Webhooks, please refer to this dedicated section.

To receive those notifications, subscribe to the following event:

For more information on the statuses, please refer to this section.

Retrieve detailed watchlist verification results

You can also obtain detailed verification results by calling a dedicated endpoint, with the id returned when requesting a watchlist verification:

GET /verifications/watchlists/{id}

Similar to the webhook, you will receive the verification status. For more information on the statuses, please refer to this section.

ℹ️ After 7 days, Watchlist Verification records are anonymized, meaning all personal or sensitive data associated with the verification request is permanently deleted. If you need to reaccess this information, you’ll need to initiate a new verification request.

List all watchlist verification requests

To retrieve a list of all verification requests, you can call the following endpoint. You can filter by status, workspace_id or paginate the results based on your needs:

GET /verifications/watchlists

Follow watchlist verification status

ℹ️

The verified and failedstatus verification does incur a charge to the client.

The company verification lifecycle is really simple and consists of the following stages: