/api/conversations/{conversationId}/aml/{list}Retrieving detailed information about the user collected during the AML process
The method retrieves data found in AML lists based on user data. Data from AML lists as defined when creating the conversation. When a continuous AML monitoring subscription is activated, only the latest available data is returned.
We can specify the list type in the query by specifying one of the following AML list types: PEP, SIP, SANCTIONS, ADVERSE_MEDIA, OTHER.
Depending on the type of list you select, the structure of the response may vary.
Response Parameters Available for PEP List Type
| Parameter | Example | Description |
|---|---|---|
| type | PERSON | Informs if entry describes user or users's relative: PERSON - user, RCA - users's relative |
| score | 0.98 | Compliance level of provided personal data with results (0-1 if provided or null) |
| reason | -- | Reason why person is on the list |
| user.person | -- | Data found on AML lists for provided person |
| user.person.name.firstName | -- | User name |
| user.person.name.lastName | -- | User surname |
| user.person.name.middleName | -- | Second name |
| user.person.name.spellings | -- | Correct spelling of name and surname (including national language) |
| user.person.name.alsoKnownAs | -- | Alias names of person under verification |
| user.person.name.alsoKnownAs.firstName | -- | User's other firstname |
| user.person.name.alsoKnownAs.lastName | -- | User's other surname |
| user.person.name.alsoKnownAs.title | -- | User alias |
| user.person.address.country | POLAND (no unified country name format) | Country of residence of the person |
| user.person.info | -- | Additional information about the person under verification |
| user.person.info.gender | MALE | The gender of the user: MALE, FEMALE, OTHER |
| user.person.info.nationality | Poland (no unified country name format) | User's nationality |
| user.person.info.birthDate | 1972-10-18 (no unified date format) | Date of birth |
| user.person.info.deceased | true/false | Information if person is dead |
| user.person.info.deceaseDate | 2020-10-18 (no unified date format) | Date of death |
| user.person.info.image | -- | URL to person's picture |
| user.person.info.roles | -- | Information about the exposed position held by the person |
| user.person.info.roles.title | -- | Position held or Unknown if position is unknown |
| user.person.info.roles.country | (no unified country name format) | The country in which the position was held or 'Unknown' if country is unknown |
| user.person.info.roles.fromDate | 2014-05-01 (no unified date format) | Start date of tenure |
| user.person.info.roles.tillDate | 2019 (no unified date format) | End date of tenure |
Response Parameters Available for SANCTIONS List Type
| Parameter | Example | Description |
|---|---|---|
| type | PERSON | Informs if entry describes user or users's relative: PERSON - user, RCA - user's relative |
| score | 0.98 | Compliance level of provided personal data with results (0-1 if provided or null) |
| reason | -- | Reason why person is on the list |
| sources | -- | Names of AML list types on which the person was found |
| user.person | -- | Data found on AML lists for provided person |
| user.person.name.firstName | -- | User name |
| user.person.name.lastName | -- | User surname |
| user.person.name.middleName | -- | Second name |
| user.person.name.spellings | -- | Correct spelling of name and surname (including national language) |
| user.person.name.alsoKnownAs | -- | Alias names of person under verification |
| user.person.name.alsoKnownAs.firstName | -- | User's other firstname |
| user.person.name.alsoKnownAs.lastName | -- | User's other surname |
| user.person.name.alsoKnownAs.title | -- | User alias |
| user.person.address.country | POLAND (no unified country name format) | Country of residence of the person |
| user.person.info | -- | Additional information about the person under verification |
| user.person.info.gender | MALE | The gender of the user: MALE, FEMALE, OTHER |
| user.person.info.nationality | Poland (no unified country name format) | User's nationality |
| user.person.info.birthDate | 1972-10-18 (no unified date format) | Date of birth |
| user.person.info.deceased | true/false | Information if person is dead |
| user.person.info.deceaseDate | 2020-10-18 (no unified date format) | Date of death |
| user.person.info.image | -- | URL to person's picture |
| user.person.info.roles | -- | Information about the exposed position held by the person |
| user.person.info.roles.title | -- | Position held or 'Unknown' if position is unknown |
| user.person.info.roles.country | (no unified country name format) | The country in which the position was held or 'Unknown' if country is unknown |
| user.person.info.roles.fromDate | 2014-05-01 (no unified date format) | Start date of tenure |
| user.person.info.roles.tillDate | 2019 (no unified date format) | End date of tenure |
Response Parameters Available for SIP List Type
| Parameter | Example | Description |
|---|---|---|
| type | PERSON | Informs if entry describes user or users's relative PERSON - user, RCA - user's relative |
| score | 0.98 | Compliance level of provided personal data with results (0-1 if provided or null) |
| reason | -- | Reason why person is on the list |
| user.person | -- | Data found on AML lists for provided person |
| user.person.name.firstName | -- | User name |
| user.person.name.lastName | -- | User surname |
| user.person.name.middleName | -- | Second name |
| user.person.name.spellings | -- | Correct spelling of name and surname (including national language) |
| user.person.name.alsoKnownAs | -- | Alias names of person under verification |
| user.person.name.alsoKnownAs.firstName | -- | User's other firstname |
| user.person.name.alsoKnownAs.lastName | -- | User's other surname |
| user.person.name.alsoKnownAs.title | -- | User alias |
| user.person.address.country | POLAND (no unified country name format) | Country of residence of the person |
| user.person.info | -- | Additional information about the person under verification |
| user.person.info.gender | MALE | The gender of the user: MALE, FEMALE, OTHER |
| user.person.info.nationality | Poland (no unified country name format) | User's nationality |
| user.person.info.birthDate | 1972-10-18 (no unified date format) | Date of birth |
| user.person.info.deceased | true/false | Information if person is dead |
| user.person.info.deceaseDate | 2020-10-18 (no unified date format) | Date of death |
| user.person.info.image | -- | URL to person's picture |
| user.person.info.roles | -- | Information about the exposed position held by the person |
| user.person.info.roles.title | -- | Position held or 'Unknown' if position is unknown |
| user.person.info.roles.country | (no unified country name format) | The country in which the position was held or Unknown if country is unknown |
| user.person.info.roles.fromDate | 2014-05-01 (no unified date format) | Start date of tenure |
| user.person.info.roles.tillDate | 2019 (no unified date format) | End date of tenure |
Response Parameters Available for ADVERSE_MEDIA List Type
| Parameter | Example | Description |
|---|---|---|
| originalUrl | -- | Link to adverse article |
| date | 2020-10-18 (date format yyyy-MM-dd) | Adverse media publication date |
| url | -- | Link to PDF with original adverse media publication |
| categories | -- | Media categorization |
Response Parameters Available for OTHER List Type
| Parameter | Example | Description |
|---|---|---|
| type | PERSON | Informs if entry describes user or users's relative: PERSON - user, RCA - user's relative |
| score | 0.98 | Compliance level of provided personal data with results (0-1 if provided or null) |
| reason | -- | Reason why person is on the list |
| user.person | -- | Data found on AML lists for provided person |
| user.person.name.firstName | -- | User name |
| user.person.name.lastName | -- | User surname |
| user.person.name.middleName | -- | Second name |
| user.person.name.spellings | -- | Correct spelling of name and surname (including national language) |
| user.person.name.alsoKnownAs | -- | Alias names of person under verification |
| user.person.name.alsoKnownAs.firstName | -- | User's other firstname |
| user.person.name.alsoKnownAs.lastName | -- | User's other surname |
| user.person.name.alsoKnownAs.title | -- | User alias |
| user.person.address.country | POLAND (no unified country name format) | Country of residence of the person |
| user.person.info | -- | Additional information about the person under verification |
| user.person.info.gender | MALE | The gender of the user: MALE, FEMALE, OTHER |
| user.person.info.nationality | Poland (no unified country name format) | User's nationality |
| user.person.info.birthDate | 1972-10-18 (no unified date format) | Date of birth |
| user.person.info.deceased | true/false | Information if person is dead |
| user.person.info.deceaseDate | 2020-10-18 (no unified date format) | Date of death |
| user.person.info.image | -- | URL to person's picture |
| user.person.info.roles | -- | Information about the exposed position held by the person |
| user.person.info.roles.title | -- | Position held or Unknown if position is unknown |
| user.person.info.roles.country | (no unified country name format) | The country in which the position was held or Unknown if country is unknown |
| user.person.info.roles.fromDate | 2014-05-01 (no unified date format) | Start date of tenure |
| user.person.info.roles.tillDate | 2019 (no unified date format) | End date of tenure |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
conversationId | path | string | Required | Conversation ID |
page | query | integer · int32 | Optional | Page number |
pageSize | query | integer · int32 | Optional | The number of items on the page |
list | path | string | Required | List name |
Responses
User found on given AML list
application/vnd.authologic.v1.1+jsonmoreboolean required Information whether there are more pages available
itemsarray<unknown> required List of information collected during AML verification
List of information collected during AML verification
entryTypestring required originalUrlstring optional Link to adverse article
datestring · date optional Adverse Media publication date or capture date
urlstring optional Link to PDF with original adverse media publication
categoriesarray<string> optional Media categorization
entryTypestring required typestring optional Informs if entry describes person or person's relative:
- PERSON - person
- RCA - person's relative
PERSONRCAscorenumber · double optional Percent compliance of provided personal data with results (0-1 if provided or null)
reasonstring optional Reason why person is on the list
userobject optional Data found on AML lists for provided person
entryTypestring required typestring optional Informs if entry describes person or person's relative:
- PERSON - person
- RCA - person's relative
PERSONRCAscorenumber · double optional Compliance level of provided personal data with results (0-1 if provided or null)
reasonstring optional Reason why person is on the list
userobject optional Data found on AML lists for provided person
entryTypestring required typestring optional Informs if entry describes person or person's relative:
- PERSON - person
- RCA - person's relative
PERSONRCAscorenumber · double optional Percent compliance of provided personal data with results (0-1 if provided or null)
reasonstring optional Reason why person is on the list
sourcesarray<string> optional Names of AML list types on which the person was found
userobject optional Data found on AML lists for provided person
entryTypestring required typestring optional Informs if entry describes person or person's relative:
- PERSON - person
- RCA - person's relative
PERSONRCAscorenumber · double optional Percent compliance of provided personal data with results (0-1 if provided or null)
reasonstring optional Reason why person is on the list
userobject optional Data found on AML lists for provided person
Bad Request
application/vnd.authologic.v1.1+jsonstatusstring required Response status
messagestring required Descriptive error message
violationsarray<object> required Validation error list
Validation error list
fieldstring required Field name
messagestring required Descriptive error message
statusDetailstring optional Response status detailed information
statusstring required Response status
messagestring required Descriptive error message
violationsarray<object> required Validation error list
Validation error list
fieldstring required Field name
messagestring required Descriptive error message
statusDetailstring optional Response status detailed information
statusstring required Response status
messagestring required Descriptive error message
violationsarray<object> required Validation error list
Validation error list
fieldstring required Field name
messagestring required Descriptive error message
statusDetailstring optional Response status detailed information
statusstring required Response status
messagestring required Descriptive error message
violationsarray<object> required Validation error list
Validation error list
fieldstring required Field name
messagestring required Descriptive error message
statusDetailstring optional Response status detailed information
statusstring required Response status
messagestring required Descriptive error message
violationsarray<object> required Validation error list
Validation error list
fieldstring required Field name
messagestring required Descriptive error message
statusDetailstring optional Response status detailed information
statusstring required Response status
messagestring required Descriptive error message
violationsarray<object> required Validation error list
Validation error list
fieldstring required Field name
messagestring required Descriptive error message
statusDetailstring optional Response status detailed information
statusstring required Response status
messagestring required Descriptive error message
violationsarray<object> required Validation error list
Validation error list
fieldstring required Field name
messagestring required Descriptive error message
statusDetailstring optional Response status detailed information
Exhaustion of the plan or limitations related to non-payment
Forbidden
application/vnd.authologic.v1.1+jsonstatusstring required Response status
messagestring required Descriptive error message
violationsarray<object> required Validation error list
Validation error list
fieldstring required Field name
messagestring required Descriptive error message
statusDetailstring optional Response status detailed information
Not found
application/vnd.authologic.v1.1+jsonstatusstring required Response status
messagestring required Descriptive error message
violationsarray<object> required Validation error list
Validation error list
fieldstring required Field name
messagestring required Descriptive error message
statusDetailstring optional Response status detailed information
Conversation is unavailable
application/vnd.authologic.v1.1+jsonstatusstring required Response status
messagestring required Descriptive error message
violationsarray<object> required Validation error list
Validation error list
fieldstring required Field name
messagestring required Descriptive error message
statusDetailstring optional Response status detailed information
Server side error