Table of Contents
...
ℹ️ Introduction
This API’s main goal is to screen persons and businesses on an ongoing basis through our AML database.
| Drawio |
|---|
| zoom | 1 |
|---|
| simple | 0 |
|---|
| inComment | 0 |
|---|
| pageId | 2355462193 |
|---|
| custContentId | 2354970667 |
|---|
| lbox | 1 |
|---|
| diagramDisplayName | Untitled Diagram.drawio |
|---|
| contentVer | 89 |
|---|
| revision | 89 |
|---|
| baseUrl | https://ondato.atlassian.net/wiki |
|---|
| diagramName | Untitled Diagram.drawio |
|---|
| pCenter | 0 |
|---|
| width | 16511500.9999999999995 |
|---|
| links | |
|---|
| tbstyle | |
|---|
| height | 521520.9999999999999 |
|---|
|
...
🛂 Authorization
To access our AML screening API you need to provide an access token in each request. (
Learn how to get an access token here
...
The API has one scope: aml_monitoring_api, which provides access to all endpoints of this API.
...
☁️ Environments
Environment | Swagger URL | Base URL | Scopes |
|---|
Sandbox
https://sandbox-amlmonitoring.ondato.com/swagger/index.html | https://sandbox-amlmonitoring.ondato.com
| registries_naturalentityvalidation_api | registriesnaturalentityvalidation...
📍 Endpoints
This API has the following endpoints:Setup and manage worklist:
1️⃣ Worklist endpoints
| Expand |
|---|
| title | Setup and manage worklist: |
|---|
| | Panel |
|---|
|
PUT | | Endpoint | Description |
|---|
| 1 | /v1/worklists | Create a new worklist | | 2 | /v1/worklists/{worklistId} |
| Panel |
|---|
|
|
GET | Retrieve a specific worklist |
| 3 | /v1/worklists/{worklistId} | Update an existing worklist |
| 4 | /v1/worklists/{worklistId} |
| Panel |
|---|
|
GET /worklists/ - get all worklists. |
| Panel |
|---|
|
DELETE | Delete a specific worklist |
| 5 | /v1/worklists/search | Get a list of created worklists |
2️⃣ Person monitoring endpoints
| Expand |
|---|
|
| Endpoint | Description |
|---|
| 1 | Monitoring | | 2 | /v1/worklists/{worklistId}/natural-entity-records/search | Get all person records in the monitoring worklist | | 3 | /v1/worklists/{worklistId} |
|
Add to monitoring and manage monitoring records
Person monitoring:
| Expand |
|---|
| title | Manage person monitoring |
|---|
|
| Panel |
|---|
|
|
PUT /natural-entity-records/batch-async
| Add multiple person records in the monitoring worklist with asynchronous operation (limit 10k records) |
| 4 | /v1/worklists/{worklistId}/natural-entity-records/batch | Add multiple person records in the monitoring worklist
(limit 25 records) |
| 5 | /v1/worklists/{worklistId}/ |
| Panel |
|---|
|
PUT batch
| Update multiple person records in the monitoring worklist (limit 25 records) |
| 6 | /v1/worklists/{worklistId}/ |
| Panel |
|---|
|
GET natural-entity-records/batch
| Delete multiple person records from the monitoring worklist (limit 25 records) |
| 7 | /v1/worklists/{worklistId}/ |
| Panel |
|---|
|
GET specific person record from the monitoring worklist |
| 8 | /v1/worklists/{worklistId}/ |
| Panel |
|---|
|
DELETE natural-entity-records/{recordId}
| Update a specific person record in the monitoring worklist |
| 9 | /v1/worklists/{worklistId}/ |
Business monitoring:
| Expand |
|---|
| title | Manage business monitoring |
|---|
|
| Panel |
|---|
|
|
PUT recordId}
| Delete a specific person record from the monitoring worklist |
| 10 | /v1/worklists/{worklistId}/ |
| Panel |
|---|
|
PUT natural-entity-records
| Create a person record in the monitoring worklist |
| 11 | /v1/worklists/{worklistId} |
/natural-entity-records/batch/{
|
| Panel |
|---|
|
GET | Get batch-async operation results |
| 12 | /v1/worklists/{worklistId} |
/natural-entity-records/batch/{
|
| Panel |
|---|
|
GET /records
| Get batch-async operation individual records and their status |
| 13 | Retrieve matches |
| 14 | /v1/worklists/{worklistId}/ |
| Panel |
|---|
|
DELETE natural-entity-records/{recordId}/search
| Search for all matches of the specific person record in the monitoring worklist |
| 15 | /v1/worklists/{worklistId}/ |
Retrieve and review matches
Person matches:
| Expand |
|---|
| title | Retrieve and review person matches |
|---|
|
| Panel |
|---|
|
|
GET recordId}/matches/{matchId}
| Search for a particular match of the specific person record in the monitoring worklist |
| 16 | /v1/worklists/{worklistId}/ |
| Panel |
|---|
|
PUT /{matchId}/reviews
| Get reviews of the match of the specific person record in the monitoring worklist |
| 17 | /v1/worklists/{worklistId}/ |
recordId}/matches/{matchId}/reviews
|
| Panel |
|---|
|
GET | Create a review for a specified match |
| 18 | /v1/worklists/{worklistId}/ |
| Panel |
|---|
|
GET /individuals/{resourceId} - get detailed person info. |
Business matches:
| Expand |
|---|
| title | Retrieve and review business matches |
|---|
|
| Panel |
|---|
| GET /worklists/{worklistId}/businesses/{monitorRecordId}/matches - get business matches. |
| Panel |
|---|
| PUT /worklists/{worklistId}/businesses/{monitorRecordId}/matches/reviews - change status and add comment. |
| Panel |
|---|
|
|
GET | Create reviews for multiple matches |
| 19 | Get record details |
| 20 | /v1/natural-entity-details/{resourceId} | Get the profile data of the person that was matched with a record |
3️⃣ Business monitoring endpoints
| Expand |
|---|
|
| Endpoint | Description |
|---|
| 1 | Monitoring | | 2 | /v1/worklists/{worklistId}/legal-entity-records/search | Get all business records in the monitoring worklist | | 3 | /v1/worklists/{worklistId}/legal-entity-records/batch-async | Add multiple business records to the monitoring worklist with asynchronous operation (limit 10k records) | | 4 | /v1/worklists/{worklistId}/legal-entity-records/batch | Add multiple business records to the monitoring worklist (limit 25 records) | | 5 | /v1/worklists/{worklistId}/legal-entity-records/batch | Update multiple business records in the monitoring worklist (limit 25 records) | | 6 | /v1/worklists/{worklistId}/legal-entity-records/batch | Delete multiple business records from the monitoring worklist (limit 25 records) | | 7 | /v1/worklists/{worklistId}/legal-entity-records/{recordId} | Get a specific business record from the monitoring worklist | | 8 | /v1/worklists/{worklistId}/ |
| Panel |
|---|
| GET /businesses/{resourceId} - get detailed business info. |
|
Billing (internal use only)
There are some endpoints, which calls are charged by external provider. These endpoints are:
| Panel |
|---|
|
PUT recordId}
| Update a specific business record in the monitoring worklist | | 9 | /v1/worklists/{worklistId}/legal-entity-records/{recordId} | Delete a specific business record from the monitoring worklist | | 10 | /v1/worklists/{worklistId}/legal-entity-records | Create a business record in the monitoring worklist | | 11 | /v1/worklists/{worklistId}/legal-entity-records/batch/{id} | Get batch-async operation results | | 12 | /v1/worklists/{worklistId}/legal-entity-records/batch/{id}/records | Get batch-async operation individual records and their status | | 13 | Retrieve matches | | 14 | /v1/worklists/{worklistId}/legal-entity-records/{recordId}/search | Search for all matches of a specific business record in the monitoring worklist | | 15 | /v1/worklists/{worklistId}/ |
|
| Panel |
|---|
|
PUT /matches/{matchId}
| Search for a particular match of a specific business record in the monitoring worklist | | 16 | /v1/worklists/{worklistId}/legal-entity-records/{recordId}/ |
|
| Panel |
|---|
|
PUT /reviews
| Get reviews of the match of the specific business record in the monitoring worklist | | 17 | /v1/worklists/{worklistId}/ |
|
| Panel |
|---|
|
PUT legal-entity-records/{recordId}/matches/{matchId}/reviews
| Create a review for a specified match | | 18 | /v1/worklists/{worklistId}/ |
|
Other AML Monitoring endpoints are free of charge.
Request limit
The request limit for this API is 5 requests per second.
| Info |
|---|
If you exceed the limit, you will not get the error. The request call will be moved to the next second. |
Monitoring
...
legal-entity-records/{recordId}/matches/reviews
| Create reviews for multiple matches | | 19 | Get record details | | | 20 | /v1/legal-entity-details/{resourceId} | Get the profile data of the business that was matched with a record |
|
Service status
| Expand |
|---|
|
| Endpoint | Description |
|---|
| 1 | /v1/information/screening-status | Get the global status of the AML service (screening frequency still depends on individual worklist configuration). |
|
...
⚙️ Worklists
To start monitoring persons or businesses, you need to set up a worklist.
To learn how to create, update, and manage your worklists, please visit this page:
...
Add to monitoring and manage monitoring records
...
Retrieve and review matches
...
Subscribe to updates
...
Check monitoring status
...
🧑🦰 Person monitoring
To monitor persons, you can use the person monitoring endpoints.
To learn how to add, update, and delete person records in your worklists, as well as how to search for matches and retrieve detailed information, please visit this page:
...
🏢 Business monitoring
To monitor businesses, you can use the business monitoring endpoints.
To learn how to add, update, and delete business records in your worklists, as well as how to search for matches and retrieve detailed information, please visit this page:
...
📁 Datasets
When setting up a worklist, you have to provide the datasets where monitoring records will be screened. Which dataset to provide in the worklist depends on the entity type, you are monitoring. Some datasets are only for person monitoring, others for businesses.
| Info |
|---|
You can find the description of all our datasets here. |
...