Table of Contents

Table of Contents

minLevel	1
maxLevel	2
outline	false
type	list
printable	false

...

ℹ️ Introduction

Once monitoring rules in the worklist are set up, you can do the following actions with persons:

Panel

bgColor	#F4F5F7

Manage person records:
- Add a person to monitoring
- Remove person from monitoring
- Update person record
- Get person records
Retrieve person matches
Get monitored person’s details

...

⚙️ Manage Person Records

1️⃣ Start monitoring a person

Info
To start monitoring a person, add it to the monitoring worklist. To do this, call the following endpoint: `POST /v1/worklists/{worklistId}/natural-entity-records`

Note
This endpoint only capable to add 1 person at a

...

🏛️ 🏢 🏘️ Add multiple businesses to the monitoring worklist

If you want to add several businesses to monitoring, call the following endpoint:

Panel

bgColor	#FFBDAD

PUT /worklists/{worklistId}/businesses - add/update multiple businesses, up to 25.

{worklistId} - worklist Id, into which businesses will be added.

Request data

Name

...

Description

...

Mandatory/Optional

...

id

...

The unique Id of monitored business set by the user.

...

Status

colour	Red
title	MANDATORY

...

name

...

The full name of the business to be monitored.

...

Status

colour	Red
title	MANDATORY

...

countries

...

The list of countries related to the business in ISO2 format.

...

Status

colour	Red
title	MANDATORY

🗒️ Example

{ "monitorRecords

time. To add multiple persons in one request, please check out the next section.

Expand

title	Example

Code Block

language	json

...

🔠 Headers

Parameter	Type	Required	Description
worklistId	string	YES	The unique Id of the worklist.
Correlation-Id	string	NO	A unique identifier assigned to the request.
Application-Id	string	NO	Your application Id. Please contact support@ondato.com you don’t have one.
Access token	string	YES	Described in the Authentication part

...

🎯 Request body

Field	Type	Required	Description
`name`	string	YES	The name of the person.
`dateOfBirth`	string	NO	Date of birth of the person. Format: YYYY-MM-DD or YYYY.
`gender`	string	NO	Gender of the person.
`referenceId`	string	NO	A unique identifier for the person’es reference in the system.
`referenceType`	string	NO	User created reference for the person in the system, for example "My Reference".

...

🥫 Response

After successfully creating a person record you’ll get a response with success code 201: Created and recordId of the person for subsequent calls.

Field	Type	Description
`id`	string	The `recordId` of the person for subsequent calls.

...

2️⃣ Bulk add persons to the monitoring

Info
You can add multiple persons to the monitoring with one call. To do this, call the following endpoint: `POST /v1/worklists/{worklistId}/natural-entity-records/batch`

Note
This endpoint capable to add up to 25 records with one call.

...

Info
`POST /v1/worklists/{worklistId}/natural-entity-records/batch-async`

Note
This endpoint capable to add up to 10.000 records with one call. Records added through this endpoint will take longer to be processed and appear in the worklist.

...

🔠 Headers

Parameter	Type	Required	Description
worklistId	string	YES	The unique Id of the worklist.
Correlation-Id	string	NO	A unique identifier assigned to the request.
Application-Id	string	NO	Your application Id. Please contact support@ondato.com you don’t have one.
Access token	string	YES	Described in the Authentication part

...

🎯 Request body

Field	Type	Required	Description
`naturalEntityRecords`	array<object>	-	An array of objects representing the person records.
naturalEntityRecords.`name`	string	YES	The name of the person.
naturalEntityRecords.`dateOfBirth`	string	NO	Date of birth of the person. Format: YYYY-MM-DD or YYYY.
naturalEntityRecords.`gender`	string	NO	Gender of the person.
naturalEntityRecords.`referenceId`	string	NO	A unique identifier for the person’es reference in the system.
naturalEntityRecords.`referenceType`	string	NO	User created reference for the person in the system, for example "My Reference".

...

🥫 Response

After successfully creating a person records you’ll get a response with success code 200: Success with fields:

Field	Type	Description
`hasErrors`	boolean	A boolean value indicating whether there are any errors in the response. If there are errors, the records array may contain error objects.
`records`	array	An array of objects representing the records in the response.
records.`id`	string	The unique identifier for the record in the system.
records.`createdAt`	string	The date and time when the record was created in ISO 8601 format.
records.`name`	string	The name of the person.
records.`dateOfBirth`	string	Date of birth of the person. Format: YYYY-MM-DD or YYYY.
records.`gender`	string	Gender of the person.
records.`referenceId`	string	A unique identifier for the person’es reference in the system.
records.`referenceType`	string	User created reference for the person in the system, for example "My Reference".
records.`error`	object	An optional object containing information about any errors associated with the record.
records.error.`code`	string	A string code identifying the type of error that occurred.
records.error.`message`	string	A human-readable message describing the error that occurred.

...

3️⃣ Stop monitoring a person

Info
To stop monitoring the person, remove it from the monitoring worklist. To do this, call the following endpoint: `DELETE /v1/worklists/{worklistId}/natural-entity-records/{recordId}`

Note
This endpoint only capable to remove 1 person at a time. To remove multiple persons in one request, please check out the section below.

...

🔠 Headers

Parameter	Type	Required	Description
worklistId	string	YES	The unique Id of the worklist.
recordId	string	YES	The unique Id of the person to update.
Correlation-Id	string	NO	A unique identifier assigned to the request.
Application-Id	string	NO	Your application Id. Please contact support@ondato.com you don’t have one.
Access token	string	YES	Described in the Authentication part

...

🥫 Response

After successfully deleting the person record from monitoring, you’ll get a response with success code 204: No Content.

...

4️⃣ Bulk remove persons from monitoring

Info
You can remove multiple persons from the monitoring with one call. To do this, call the following endpoint: `DELETE /v1/worklists/{worklistId}/natural-entity-records/batch`

Note
This endpoint capable to remove up to 25 records with one call.

...

🔠 Headers

Parameter	Type	Required	Description
worklistId	string	YES	The unique Id of the worklist.
Correlation-Id	string	NO	A unique identifier assigned to the request.
Application-Id	string	NO	Your application Id. Please contact support@ondato.com you don’t have one.
Access token	string	YES	Described in the Authentication part

...

🎯 Request body

Field	Type	Required	Description
`naturalEntityRecords`	array<object>	-	An array of objects representing id’s of person records.
naturalEntityRecords.`id`	string		The `recordId` of the person to be removed.

...

🥫 Response

After successfully deleting person records from monitoring, you’ll get a response with success code 200: Success with fields:

Field	Type	Description
`hasErrors`	boolean	A boolean value indicating whether there are any errors in the response. If there are errors, the records array may contain error objects.
`deletedRecords`	array	An array of objects representing the records in the response.
deletedRecords.`id`	string	The `recordId` of the removed person.
deletedRecords.`error`	object	An optional object containing information about any errors associated with the record.
deletedRecords.error.`code`	string	A string code identifying the type of error that occurred.
deletedRecords.error.`message`	string	A human-readable message describing the error that occurred.

...

5️⃣ Update person monitoring record

Info
You can update existing person record. To do this, call the following endpoint: `PUT /v1/worklists/{worklistId}/natural-entity-records/{recordId}`

Note
This endpoint only capable to update 1 person at a time. To update multiple persons in one request, please see the next section.

...

🔠 Headers

Parameter	Type	Required	Description
worklistId	string	YES	The unique Id of the worklist.
recordId	string	YES	The unique Id of the person to update.
Correlation-Id	string	NO	A unique identifier assigned to the request.
Application-Id	string	NO	Your application Id. Please contact support@ondato.com you don’t have one.
Access token	string	YES	Described in the Authentication part

...

🎯 Request body

Field	Type	Required	Description
`name`	string	YES	The updated name of the person.
records.`dateOfBirth`	string	NO	Date of birth of the person. Format: YYYY-MM-DD or YYYY.
records.`gender`	string	NO	Gender of the person.
`referenceId`	string	NO	An updated identifier for the person’es reference in the system.
`referenceType`	string	NO	An updated reference for the person in the system.

...

🥫 Response

After successfully updating a person record, you’ll get a response with success code 204: No Content.

...

6️⃣ Bulk update person monitoring records

Info
You can update multiple persons with one call. To do this, call the following endpoint: `PUT /v1/worklists/{worklistId}/natural-entity-records/batch`

Note
This endpoint capable to update up to 25 records with one call.

...

🔠 Headers

Parameter	Type	Required	Description
worklistId	string	YES	The unique Id of the worklist.
Correlation-Id	string	NO	A unique identifier assigned to the request.
Application-Id	string	NO	Your application Id. Please contact support@ondato.com you don’t have one.
Access token	string	YES	Described in the Authentication part

...

🎯 Request body

Field	Type	Required	Description
`naturalEntityRecords`	array<object>	-	An array of objects representing the person records.
naturalEntityRecords.`name`	string	YES	The updated name of the person.
naturalEntityRecords.`dateOfBirth`	string	NO	Date of birth of the person. Format: YYYY-MM-DD or YYYY.
naturalEntityRecords.`gender`	string	NO	Gender of the person.
naturalEntityRecords.`referenceId`	string	NO	An updated identifier for the person’es reference in the system.
naturalEntityRecords.`referenceType`	string	NO	Updated reference for the person in the system.
naturalEntityRecords.`id`	string	YES	The unique Id of the person which will be updated.

...

🥫 Response

After successfully updating person records, you’ll get a response with success code 200: Success with fields:

Field	Type	Description
`hasErrors`	boolean	A boolean value indicating whether there are any errors in the response. If there are errors, the records array may contain error objects.
`records`	array	An array of objects representing the records in the response.
records.`id`	string	The unique identifier for the record in the system.
records.`createdAt`	string	The date and time when the record was created in ISO 8601 format.
records.`name`	string	The name of the person.
records.`dateOfBirth`	string	Date of birth of the person. Format: YYYY-MM-DD or YYYY.
records.`gender`	string	Gender of the person.
records.`referenceId`	string	A unique identifier for the person’es reference in the system.
records.`referenceType`	string	User created reference for the person in the system, for example "My Reference".
records.`error`	object	An optional object containing information about any errors associated with the record.
records.error.`code`	string	A string code identifying the type of error that occurred.
records.error.`message`	string	A human-readable message describing the error that occurred.

...

7️⃣ Retrieve a specific person monitoring record

Info
You can retrieve information about a specific person record. To do this, call the following endpoint: `GET /v1/worklists/{worklistId}/natural-entity-records/{recordId}`

Note
This endpoint only capable to retrieve 1 person at a time. To retrive multiple persons in one request, please see the next section.

...

🔠 Headers

Parameter	Type	Required	Description
worklistId	string	YES	The unique Id of the worklist.
recordId	string	YES	The unique Id of the person to retrieve.
Correlation-Id	string	NO	A unique identifier assigned to the request.
Application-Id	string	NO	Your application Id. Please contact support@ondato.com you don’t have one.
Access token	string	YES	Described in the Authentication part

...

🥫 Response

After successfully retrieving a person record you’ll get a response with success code 200: Success with fields:

Field	Type	Description
`id`	string	The unique identifier for the record in the system.
`createdAt`	string	Date and time when the response was created.
`name`	string	The name of the person associated with the response.
`dateOfBirth`	string	Date of birth of the person. Format: YYYY-MM-DD or YYYY.
`gender`	string	Gender of the person.
`referenceId`	string	A unique identifier for the person’es reference in the system.
`referenceType`	string	User created reference for the person in the system, for example "My Reference".
`openCount`	integer	The number of open matches for the monitor record
`falsePositiveCount`	integer	The number of matches already closed as false positive
`truePositiveCount`	integer	The number of matches already closed as true positive.
`discardedCount`	integer	The number of matches already discarded.
`createdDateTimeIso`	string	Date and time when the person record was first created.
`lastUpdatedDateTimeIso`	string	Date and time when the person record was last updated.

...

8️⃣ Retrieve all person monitoring records

Info
You can retrieve information about all person records in the worklist. To do this, call the following endpoint: `POST /v1/worklists/{worklistId}/natural-entity-records/search`

...

🔠 Headers

Parameter	Type	Required	Description
worklistId	string	YES	The unique Id of the worklist.
Correlation-Id	string	NO	A unique identifier assigned to the request.
Application-Id	string	NO	Your application Id. Please contact support@ondato.com you don’t have one.
Access token	string	YES	Described in the Authentication part

...

🎯 Request body

Note
All request fields are optional. They can be passed to narrow the search.

Field	Type	Required	Description
`id`	string	NO	The unique identifier for the record in the system.
`dateOfBirth`	string	NO	Date of birth of the person. Format: YYYY-MM-DD or YYYY.
`gender`	string	NO	Gender of the person.
`name`	string	NO	The name of the person.
`referenceId`	string	NO	A unique identifier for the person’es reference in the system.
`referenceType`	string	NO	User created reference for the person in the system, for example "My Reference".
`from`	string	NO	Date FROM when person record was added to worklist. Response will return person records added after this date.
`to`	string	NO	Date TO when person record was added to worklist. Response will return person records added before this date.

...

🥫 Response

After successfully retrieving a person records, you’ll get a response with success code 200: Success with fields:

Field	Type	Description
`hasErrors`	boolean	A boolean value indicating whether there are any errors in the response. If there are errors, the records array may contain error objects.
`records`	array	An array of objects representing the records in the response.
records.`id`	string	The unique identifier for the record in the system.
records.`createdAt`	string	The date and time when the record was created in ISO 8601 format.
records.`name`	string	The name of the person.
records.`dateOfBirth`	string	Date of birth of the person. Format: YYYY-MM-DD or YYYY.
records.`gender`	string	Gender of the person.
records.`referenceId`	string	A unique identifier for the person’es reference in the system.
records.`referenceType`	string	User created reference for the person in the system, for example "My Reference".
records.`error`	object	An optional object containing information about any errors associated with the record.
records.error.`code`	string	A string code identifying the type of error that occurred.
records.error.`message`	string	A human-readable message describing the error that occurred.

...

🛒 Retrieve Person Matches

If any of your monitored person records gets a match in our AML datasets, you can retrieve it.

...

1️⃣ Retrieve all matches of the person

Info
You can retrieve all matches of the person. To do this, call the following endpoint: `POST /v1/worklists/{worklistId}/natural-entity-records/{recordId}/search`

...

🔠 Headers

Parameter	Type	Required	Description
worklistId	string	YES	The unique Id of the worklist.
recordId	string	YES	The unique Id of the person record to retrieve.
Correlation-Id	string	NO	A unique identifier assigned to the request.
Application-Id	string	NO	Your application Id. Please contact support@ondato.com you don’t have one.
Access token	string	YES	Described in the Authentication part

...

🥫 Response

After successfully retrieving the person matches you’ll get a response with success code 201: Created with fields:

Field	Type	Description
`totalCount`	integer	Total number of matches.
`matches`	array<object>	An array of objects representing the match information.
matches.`currentStatus`	string	Current status of the person match. Possible enum values: `Open` - match requires review. `TruePositive` - match closed as true positive `FalsePositive` - match closed as false positive `Discarded` - match was discarded
matches.`matchId`	string	The unique Id of the person match.
matches.`version`	integer	Can be used to detect when the profile has changed.
matches.`resourceId`	string	The unique id that can be used to retrieve the detailed information about person profile via `GET /v1/natural-entity-details/{resourceId}` endpoint.
matches.`score`	integer	The match score. This means how accurate the found person match the monitored person. E.g. `"score": 100` means that the found person is the exact match to the provided in the monitoring. Possible values from `75` to `100`
matches.`match`	string	The person name that has been matched in the monitoring.
matches.`name`	string	The name of the found person.
matches.`countries`	string	The list of countries from the addresses and nationalities of the profile.
matches.`datesOfBirth`	array<string>	An array of strings representing the person dates of birth. Format: YYYY-MM-DD or YYYY.
matches.`gender`	string	Gender of the person.
matches.`profileImage`	string	The URL to person’s profile image.
matches.`dataSets`	string	Active datasets where person is tagged in. Possible enum values are any of the described datasets here.
matches.`matchVersion`	integer	This value can be used for version control.

...

2️⃣ Retrieve a specific match of the person

Info
You can retrieve a specific person’es match. To do this, call the following endpoint: `GET /v1/worklists/{worklistId}/natural-entity-records/{recordId}/matches/{matchId}`

...

🔠 Headers

Parameter	Type	Required	Description
worklistId	string	YES	The unique Id of the worklist.
recordId	string	YES	The unique Id of the person record to retrieve.
matchId	string	YES	The unique Id of the person match to retrieve.
Correlation-Id	string	NO	A unique identifier assigned to the request.
Application-Id	string	NO	Your application Id. Please contact support@ondato.com you don’t have one.
Access token	string	YES	Described in the Authentication part

...

🥫 Response

After successfully retrieving a person match you’ll get a response with success code 200: Success with fields:

Field	Type	Description
`currentStatus`	string	Current status of the person match. Possible enum values: `Open` - match requires review. `TruePositive` - match closed as true positive `FalsePositive` - match closed as false positive `Discarded` - match was discarded
`matchId`	string	The unique Id of the person match.
`version`	string	Can be used to detect when the profile has changed.
`resourceId`	string	The unique id that can be used to retrieve the detailed information about person profile via `GET /v1/natural-entity-details/{resourceId}` endpoint.
`score`	string	The match score. This means how accurate the found person match the monitored person. E.g. `"score": 100` means that the found person is the exact match to the provided in the monitoring. Possible values from `75` to `100`
`match`	integer	The person name that has been matched in the monitoring.
`name`	integer	The name of the found person.
`countries`	integer	The list of countries from the addresses and nationalities of the profile.
`datesOfBirth`	array<string>	An array of strings representing the person dates of birth. Format: YYYY-MM-DD or YYYY.
`gender`	string	Gender of the person.
`profileImage`	string	The URL to person’s profile image.
`dataSets`	integer	Active datasets where person is tagged in. Possible enum values are any of the described datasets here.
`matchVersion`	string	This value can be used for version control.

...

📥 Get Monitored Person Match Details

Info
After retrieving the person match, you can get detailed information about a matched person. To do this, call the following endpoint: `GET /v1/natural-entity-details/{resourceId}`

...

🔠 Headers

Parameter	Type	Required	Description
resourceId	string	YES	The unique Id of the matched person profile to retrieve the detailed information.
Correlation-Id	string	NO	A unique identifier assigned to the request.
Application-Id	string	NO	Your application Id. Please contact support@ondato.com you don’t have one.
Access token	string	YES	Described in the Authentication part

...

🥫 Response

After successfully retrieving details of the matched person profile, you’ll get a response with success code 200: Success and the response.

Info
The response structure is the same as for our AML Screening response. You can check it out here: https://ondato.atlassian.net/wiki/spaces/PUB/pages/2379612161/Person+AML+Screening#%F0%9F%93%87-Get-person-details-by-id

...

🗂️ Code Examples

1️⃣ Start monitoring a person

🗒️ Example request

Expand

title	Expand to see the example request

Code Block

language	json

{
  "name": "Boyko Borissov",
  "dateOfBirth": "1994-08-22",
  "gender": "Male",
  "referenceId": "02241D31-2058-45AD-8D03-6AACF97863B8",
  "referenceType": "My Reference"
}

🗒️ Example response

Expand

title	Expand to see the example response

Code Block

language	json

{
  "id": "54d0e87303644a599651f7d0bab9e952"
}

...

2️⃣ Bulk add multiple persons to the monitoring

🗒️ Example request

Expand

title	Expand to see the example request

Code Block

language	json

{
  "naturalEntityRecords": [
    {
      "name": "Boyko Borissov",
      "dateOfBirth": "1994-08-22",
      "gender": "Male",
      "referenceId": "02241D31-2058-45AD-8D03-6AACF97863B8",
      "referenceType": "My Reference"
    }
  ]
}

🗒️ Example response

Expand

title	Expand to see the example response

Code Block

language	json

{
  "hasErrors": false,
  "records": [
    {
      "id": "b078226e94d844c99a681dad7f61dce8",
      "createdAt": "HighRiskProfile3002023-03-20T12:02:24.395Z",
      "name": "Boyko Borissov",
      "dateOfBirth": "1994-08-22",
      "gender": "Male",
      "referenceId": "02241D31-2058-45AD-8D03-6AACF97863B8",
      "referenceType": "IBMMy CorporationReference",
      "error": {
        "countriescode": "MS101",
[        "message": "US"
Error message"
      }
    }
  ]
}

...

3️⃣ Bulk remove persons from monitoring

🗒️ Example request

Expand

title	Expand to see the example request

Code Block

language	json

{
  "naturalEntityRecords": [
    {
      "id": "b078226e94d844c99a681dad7f61dce8"
    }
  ]
}

Response data

In the response, you’ll get the results array with status codes, the same as for persons.

...

If you want to add a single business to monitoring, call the following endpoint:

Panel

bgColor	#FFBDAD

PUT /worklists/{worklistId}/businesses/{monitorRecordId} - add/update single business, providing it's Id.

{worklistId} - worklist Id, into which persons will be added.

{monitorRecordId} - the unique Id of the business, who will be monitored.

Request data

Name

...

Description

...

Mandatory/Optional

...

name

...

The full name of the business to be monitored.

...

Status

colour	Red
title	MANDATORY

...

countries

...

The list of countries related to business in ISO2 format.

...

Status

colour	Red
title	MANDATORY

🗒️ Example

Expand

title	Example

Code Block

language	json

🗒️ Example response

Expand

title	Expand to see the example response

Code Block

language	json

{
  "hasErrors": true,
  "deletedRecords": [
    {
      "id": "b078226e94d844c99a681dad7f61dce8",
      "error": {
        "code": "MS101",
        "message": "Error message"
      }
    }
  ]
}

...

4️⃣ Update person monitoring record

🗒️ Example request

Expand

title	Expand to see the example request

Code Block

language	json

{
  "name": "Boyko Borissov",
  "dateOfBirth": "1994-08-22",
  "gender": "Male",
  "referenceId": "02241D31-2058-45AD-8D03-6AACF97863B8",
  "referenceType": "My Reference"
}

5️⃣ Bulk update person monitoring records

🗒️ Example request

Expand

title	Expand to see the example request

Code Block

language	json

{
  "naturalEntityRecords": [
    {
      "name": "Boyko Borissov",
      "dateOfBirth": "1994-08-22",
      "gender": "Male",
      "referenceId": "02241D31-2058-45AD-8D03-6AACF97863B8",
      "referenceType": "My Reference",
      "id": "b078226e94d844c99a681dad7f61dce8"
    }
  ]
}

🗒️ Example response

Expand

title	Expand to see the example response

Code Block

language	json

{
  "hasErrors": false,
  "records": [
    {
      "id": "b078226e94d844c99a681dad7f61dce8",
      "createdAt": "2023-03-20T12:03:20.891Z",
      "name": "Boyko Borissov",
      "dateOfBirth": "1994-08-22",
      "gender": "Male",
      "referenceId": "02241D31-2058-45AD-8D03-6AACF97863B8",
      "referenceType": "My Reference",
      "error": {
        "code": "MS101",
        "message": "Error message"
      }
    }
  ]
}

...

6️⃣ Retrieve a specific person monitoring record

🗒️ Example response

Expand

title	Expand to see the example response

Code Block

language	json

{
  "id": "b078226e94d844c99a681dad7f61dce8",
  "createdAt": "2023-03-20T12:03:45.415Z",
  "name": "Boyko Borissov",
  "dateOfBirth": "1994-08-22",
  "gender": "Male",
  "referenceId": "02241D31-2058-45AD-8D03-6AACF97863B8",
  "referenceType": "My Reference",
  "openCount": 0,
  "falsePositiveCount": 0,
  "truePositiveCount": 0,
  "discardedCount": 0,
  "createdDateTimeIso": "2021-10-05T10:10:08.270Z",
  "lastUpdatedDateTimeIso": "2021-10-05T10:10:08.270Z"
}

...

7️⃣ Retrieve all person monitoring records

🗒️ Example request

Expand

title	Expand to see the example request

Code Block

language	json

{
  "id": "b078226e94d844c99a681dad7f61dce8",
  "dateOfBirth": "1994-08-22",
  "gender": "Male",
  "name": "Boyko Borissov",
  "referenceId": "02241D31-2058-45AD-8D03-6AACF97863B8",
  "referenceType": "My Reference",
  "from": "2023-01-01",
  "to": "2023-12-31"
}

🗒️ Example response

Expand

title	Expand to see the example response

Code Block

language	json

{
  "hasErrors": false,
  "records": [
    {
      "id": "b078226e94d844c99a681dad7f61dce8",
      "createdAt": "2023-03-20T12:03:59.360Z",
      "name": "Boyko Borissov",
      "dateOfBirth": "1994-08-22",
      "gender": "Male",
      "referenceId": "02241D31-2058-45AD-8D03-6AACF97863B8",
      "referenceType": "My Reference",
      "error": {
        "code": "MS101",
        "message": "Error message"
      }
    }
  ]
}

...

8️⃣ Retrieve all matches of the person

🗒️ Example response

Expand

title	Expand to see the example response

Code Block

language	json

{
  "totalCount": 15,
  "matches": [
    {
      "currentStatus": "Open",
      "matchId": "432523",
      "version": 15346444345,
      "resourceId": "1f5a940e6a16d390bfe75055c3176f64c5b397880ff08e04b61ad7325af76cc4",
      "score": 100,
      "match": "Boyko Borissov",
      "name": "IBMBoyko Metodiev CorporationBorisov",
      "countries": [
        "US"
      ],
      "datesOfBirth": [
        "1994",
        "1994-08-22"
      ],
      "gender": "Male",
      "profileImage": "https://www.acurisriskintelligence.com/cdn/content/0024300000/0024297990.jpg",
      "dataSets": [
        "ExternalPepCurrent",
        "ExternalSanctionsCurrent"
      ],
      "matchVersion": 1
    }
  ]
}

Response data

After successfully adding a business to the monitoring worklist you’ll get a response with success code 201: Created.

Update monitoring record

Retrieve monitoring record

...

9️⃣ Retrieve a specific match of the person

🗒️ Example response

Expand

title	Expand to see the example response

Code Block

language	json

{
  "currentStatus": "Open",
  "matchId": "432523",
  "version": 15346444345,
  "resourceId": "1f5a940e6a16d390bfe75055c3176f64c5b397880ff08e04b61ad7325af76cc4",
  "score": 100,
  "match": "Boyko Borissov",
  "name": "Boyko Metodiev Borisov",
  "countries": [
    "US"
  ],
  "datesOfBirth": [
    "1994",
    "1994-08-22"
  ],
  "gender": "Male",
  "profileImage": "https://www.acurisriskintelligence.com/cdn/content/0024300000/0024297990.jpg",
  "dataSets": [
    "ExternalPepCurrent",
    "ExternalSanctionsCurrent"
  ],
  "matchVersion": 1
}

...

🔟 Get monitored person match details

Info
Example can be found here: https://ondato.atlassian.net/wiki/spaces/PUB/pages/2379612161/Person+AML+Screening#%F0%9F%93%87-Get-person-details-by-id

...

Version	Old Version 10	New Version Current
Changes made by	Pavelas Bulatovas (Deactivated)	Priit Aavik
Saved on	Dec 07, 2022	Jan 26, 2024

Content Comparison

Versions Compared

Key

ℹ️ Introduction

⚙️ Manage Person Records

1️⃣ Start monitoring a person

🏛️ 🏢 🏘️ Add multiple businesses to the monitoring worklist

Request data

🗒️ Example

🔠 Headers

🎯 Request body

🥫 Response

2️⃣ Bulk add persons to the monitoring

🔠 Headers

🎯 Request body

🥫 Response

3️⃣ Stop monitoring a person

🔠 Headers

🥫 Response

4️⃣ Bulk remove persons from monitoring

🔠 Headers

🎯 Request body

🥫 Response

5️⃣ Update person monitoring record

🔠 Headers

🎯 Request body

🥫 Response

6️⃣ Bulk update person monitoring records

🔠 Headers

🎯 Request body

🥫 Response

7️⃣ Retrieve a specific person monitoring record

🔠 Headers

🥫 Response

8️⃣ Retrieve all person monitoring records

🔠 Headers

🎯 Request body

🥫 Response

🛒 Retrieve Person Matches

1️⃣ Retrieve all matches of the person

🔠 Headers

🥫 Response

2️⃣ Retrieve a specific match of the person

🔠 Headers

🥫 Response

📥 Get Monitored Person Match Details

🔠 Headers

🥫 Response

🗂️ Code Examples

1️⃣ Start monitoring a person

🗒️ Example request

🗒️ Example response

2️⃣ Bulk add multiple persons to the monitoring

🗒️ Example request

🗒️ Example response

3️⃣ Bulk remove persons from monitoring

🗒️ Example request

Response data

Request data

🗒️ Example

🗒️ Example response

4️⃣ Update person monitoring record

🗒️ Example request

5️⃣ Bulk update person monitoring records

🗒️ Example request

🗒️ Example response

6️⃣ Retrieve a specific person monitoring record

🗒️ Example response

7️⃣ Retrieve all person monitoring records

🗒️ Example request

🗒️ Example response

8️⃣ Retrieve all matches of the person

🗒️ Example response

Response data

Update monitoring record

Retrieve monitoring record

9️⃣ Retrieve a specific match of the person

🗒️ Example response

🔟 Get monitored person match details