Request a Watchlists Ongoing Monitoring
On this page, you will learn how to subscribe to a natural person using the API.
Coming soon — Legal personsMonitoring of legal persons (companies) is coming soon for France. Stay tuned.
A subscription is created asynchronously: the endpoint returns immediately with the pending status, and the monitoring becomes active once the subscription is confirmed (you'll be notified with the monitoring.natural_person.activated webhook).
Monitor a natural person
Send the person's first_name, last_name and born_on using the following endpoint:
The same person cannot be monitored twice in the same workspace. If you POST a subscription for a natural person that already has a
pendingoractivemonitoring in that workspace, the API returns a400 Bad Requestwith the error typenatural_person_monitoring.already_exists.
The identity comparison ignores case, accents and leading or trailing spaces. The same person can be monitored in two different workspaces of the organization, and can be monitored again once a previous monitoring iscanceledorinconclusive.
POST /monitorings/natural_persons
Request payload
{
"workspace_id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
"first_name": "Emmanuel",
"last_name": "Macron",
"born_on": "1977-12-21"
}Response payload
{
"id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
"workspace_id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
"created_at": "2025-02-12T23:59:59+00:00",
"updated_at": "2025-02-12T23:59:59+00:00",
"status": "pending",
"status_codes": [],
"first_name": "Emmanuel",
"last_name": "Macron",
"born_on": "1977-12-21"
}In the response, you'll find the id. This value identifies the monitoring in the webhook payloads and is required to cancel it.
Request body properties
Strict matching recommendedFor natural persons,
first_name,last_nameandborn_onmust exactly match the monitored person's identity information. For example, if the name is "John Doe Smith", do not send only "John Doe" or "John Smith".
| Property | Description | Example |
|---|---|---|
first_name | Required. The first name of the natural person to monitor (255 characters max) | Emmanuel |
last_name | Required. The last name of the natural person to monitor (255 characters max) | Macron |
born_on | Required. The birth date of the natural person to monitor (valid date, format: YYYY-MM-DD) | 1977-12-21 |
workspace_id | Optional (nullable UUID). Scopes the monitoring to a specific workspace. Defaults to the main workspace if not specified. Any unknown property is rejected with a 400 Bad Request. | 090b4f7e-25e8-423d-9387-741f6188ba7a |
Updated 1 day ago