AML Screening Check

What kind of data I will get

By using this integration you will be able to screen your clients against against ComplyCube's Sanctions & Watchlists, PEP, and Adverse Media database.

Integration Scope

You can choose between two check types

  • standard_screening_check

  • extensive_screening_check

Input

You can configure users' input that will be send to comply cube in order to get the most of the verifications.

FieldDescriptionTypeRequired

email

The client's email address.

string

Yes

mobile

The client's mobile number.

string

No

telephone

The client's telephone number.

string

No

joinedDate

The date and time when the client was registered with you. This is relevant for users that migrate existing customers.

string (format YYYY-MM-DD)

No

Primary details for a client of type person

object

Yes if client is of type person

Primary details for a client of type company

object

Yes if client is of type company

Primary details of a client's address

object

Yes if proof of address check is selected

PersonDetails

FieldDescriptionTypeRequired

firstName

The client's first name.

string

Yes (required when client is a person)

middleName

The client's middle name.

string

No

lastName

The client's last name.

string

Yes (required when client is a person)

dob

The client's date of birth.

string (format YYYY-MM-DD)

No

gender

The client's gender.

string (possible values include: male, female, other)

No

nationality

The client's nationality.

string (2 letter country ISO code)

No

birthCountry

The client's birth country.

string (2 letter country ISO code)

No

ssn

The client's SSN (Social Security Number). This is for US clients.

string

No

socialInsuranceNumber

The client's Social Insurance Number.

string

No

nationalIdentityNumber

The client's National Identity Number.

string

No

taxIdentificationNumber

The client's Tax Identification Number (TIN).

string

No

CompanyDetails

FieldDescriptionTypeRequired

name

Name of the company.

string

Yes (required if client is company)

website

Website of the company.

string

No

registrationNumber

Registration number of the company.

string

No

incorporationCountry

Country where the company is incorporated.

string (2 letter country ISO code)

No

incorporationType

Type of incorporation of the company.

string (possible values include:

  1. sole_proprietorship

  2. private_limited_company

  3. public_limited_company

  4. limited_partnership

  5. holding_company

  6. non_government_organisation

  7. statutory_company

  8. subsidiary_company

  9. unlimited_partnership

  10. charitable_incorporated_organisation

  11. chartered_company)

No

Address

FieldDescriptionTypeRequired

type

Type of address.

string (possible values include:

  • main

  • alternative

  • other)

No

propertyNumber

Property number (if applicable).

string

No

buildingName

Building name (if applicable).

string

No

line

Address line.

string

Yes

city

City in the address.

string

Yes

state

State in the address.

string

No

postalCode

Postal code of the address.

string

No

country

Country of the address. (2 letter country ISO code)

string (2 letter country ISO code)

Yes

fromDate

Start date of residing at this address.

string (format YYYY-MM-DD)

No

toDate

End date of residing at this address.

string (format YYYY-MM-DD)

No

The more data you provide for a client, the more accurate the AML Screening Check results. This will ultimately reduce the number of potential 'false positive' matches.

It is highly recommended that you provide the client's date of birth in addition to the first and last names of persons.

Input Example

{
    "email": "test@transactionlink.io",
    "personDetails": {
        "firstName": "John",
        "lastName": "Doe",
        "dob": "1990-01-01",
        "nationality": "GB"
    },
    "address": {
        "line": "Polna 12/3",
        "city": "Warsaw",
        "country": "PL"
    }
}

Output

Checks Result

AttributeTypeDescription

state

String

State of the AML screening check (e.g., "FINISHED").

outcome

String

Outcome of the AML screening check (e.g., "attention").

breakdown

Object

Breakdown of the AML screening check results.

Breakdown

AttributeTypeDescription

summary

Object

Outcome summary of the check.

matches

Array

List of match objects containing details of entities that matched with the screened client's details.

Match

AttributeTypeDescription

id

String

Unique identifier for a match.

score

Number

Match score calculated by ComplyCube. A higher score indicates a closer match.

status

String

Match status.

details

Object

Details of a match.

breakdown

Array

Breakdown of the match, including risk-weighted scores and field values.

Classifications

AttributeTypeDescription

pep

Array

Array of PEP classifications.

Images

AttributeTypeDescription

images

Array

Array of URIs of images for the match.

Name

AttributeTypeDescription

type

String

Type of name (primary, alias, localised_name).

firstName

String

First name of the match.

middleName

String

Middle name of the match.

lastName

String

Last name of the match.

entityName

String

Complete name of the match (returned for person and company).

Occupation

AttributeTypeDescription

type

String

Type of occupation.

category

String

Category of the occupation.

title

String

Role title.

fromDate

Object

Start date of the occupation (structured date).

toDate

Object

End date of the occupation (structured date).

Date

AttributeTypeDescription

type

String

Type of date.

date

Object

Structured date.

Address

AttributeTypeDescription

line

String

Line of the address.

city

String

City or town of the address.

postalCode

String

Post or zip code of the client's address.

country

String

Country of the address (two-letter country ISO code).

Reference

AttributeTypeDescription

source

String

Source name.

fromDate

Object

Start date of the source's validity (structured date).

toDate

Object

End date of the source's validity (structured date).

Identification

AttributeTypeDescription

type

String

Type of identification.

value

String

Value or reference associated with the identification.

Dates

AttributeTypeDescription

dates

Array

Array of value pair objects covering important dates associated with the match.

{
    "complyCube": {
        "amlScreening": [
            {
                "client": {
                    "id": "5eb04fcd0f3e360008035eb1",
                    "type": "person",
                    "email": "victor.sheyman@example.com",
                    "mobile": "+12345678910",
                    "telephone": "+12 345678910",
                    "joinedDate": "2020-01-01",
                    "personDetails": {
                        "firstName": "Victor",
                        "lastName": "Sheyman",
                        "dob": "1990-01-01",
                        "nationality": "GB"
                    },
                    "createdAt": "2020-01-04T17:24:29.146Z",
                    "updatedAt": "2020-01-04T17:24:29.146Z"
                },
                "checksResult": {
                    "amlScreeningCheck": {
                        "state": "FINISHED",
                        "outcome": "attention",
                        "breakdown": {
                           "summary": {
                              "otherLists": {
                                 "associatedEntity": "attention",
                                 "organisedCrime": "clear",
                                 "financialCrime": "clear",
                                 "taxCrime": "clear",
                                 "corruption": "clear",
                                 "trafficking": "clear"
                              },
                              "pep": {
                                 "level2": "attention",
                                 "level3": "attention",
                                 "level1": "attention",
                                 "level4": "clear"
                              },
                              "watchlist": {
                                 "sanctionsLists": "clear",
                                 "otherOfficialLists": "clear",
                                 "warCrimes": "clear",
                                 "terror": "clear",
                                 "otherExclusionLists": "clear",
                                 "sanctionsControlAndOwnership": "clear"
                              },
                              "adverseMedia": {
                                 "environmentProduction": "clear",
                                 "socialLabour": "clear",
                                 "competitiveFinancial": "clear",
                                 "regulatory": "clear"
                              }
                           },
                           "matches": [
                              {
                                 "id": "5ebe5880fd7de4000876118f",
                                 "score": 100,
                                 "status": "attention",
                                 "details": {
                                    "entityName": "Viktor Vladimirovich Sheyman",
                                    "entityType": "person",
                                    "gender": "male",
                                    "deceased": false,
                                    "names": [
                                       {
                                          "type": "primary",
                                          "firstName": "Viktor",
                                          "middleName": "Vladimirovich",
                                          "lastName": "Sheyman",
                                          "entityName": "Viktor Vladimirovich Sheyman"
                                       },
                                       {
                                          "type": "localised_name",
                                          "entityName": "Віктар Уладзіміравіч Шэйман"
                                       },
                                       {
                                          "type": "localised_name",
                                          "entityName": "Шейман Виктор Владимирович"
                                       },
                                       {
                                          "type": "localised_name",
                                          "entityName": "Виктор Владимирович Шейман"
                                       },
                                       {
                                          "type": "alias",
                                          "firstName": "Victor",
                                          "middleName": "Vladimirovich",
                                          "lastName": "Sheyman",
                                          "entityName": "Victor Vladimirovich Sheyman"
                                       },
                                       {
                                          "type": "alias",
                                          "firstName": "Victor",
                                          "middleName": "Vladimirovich",
                                          "lastName": "Sheiman",
                                          "entityName": "Victor Vladimirovich Sheiman"
                                       }
                                    ],
                                    "countries": [
                                       {
                                          "type": "Born in",
                                          "country": "BY"
                                       },
                                       {
                                          "type": "Citizenship",
                                          "country": "BY"
                                       },
                                       {
                                          "type": "Resident of",
                                          "country": "BY"
                                       },
                                       {
                                          "type": "Jurisdiction",
                                          "country": "BY"
                                       }
                                    ],
                                    "birthPlaces": [
                                       "Grodno region,Belarus",
                                       "Hrodna region,Belarus",
                                       "Soltanishka, Voronovskovo,Belarus",
                                       "Soltanishki,Belarus",
                                       "Belarus"
                                    ],
                                    "occupations": [
                                       {
                                          "type": "Primary Occupation",
                                          "category": "Senior Civil Servants-National Government",
                                          "title": "Head, President's Office",
                                          "fromDate": {
                                             "day": "21",
                                             "month": "01",
                                             "year": "2013"
                                          }
                                       },
                                       {
                                          "type": "Previous Roles",
                                          "category": "Senior Civil Servants-National Government",
                                          "title": "State Secretary, National Security Council",
                                          "fromDate": {
                                             "day": "20",
                                             "month": "03",
                                             "year": "2006"
                                          },
                                          "toDate": {
                                             "day": "08",
                                             "month": "07",
                                             "year": "2008"
                                          }
                                       },
                                       {
                                          "type": "Previous Roles",
                                          "category": "Senior Civil Servants-National Government",
                                          "title": "State Secretary, National Security Council",
                                          "fromDate": {
                                             "month": "12",
                                             "year": "1995"
                                          },
                                          "toDate": {
                                             "year": "2000"
                                          }
                                       },
                                       {
                                          "type": "Previous Roles",
                                          "category": "Senior Members of the Judiciary",
                                          "title": "Prosecutor General",
                                          "fromDate": {
                                             "year": "2000"
                                          },
                                          "toDate": {
                                             "month": "11",
                                             "year": "2004"
                                          }
                                       },
                                       {
                                          "type": "Previous Roles",
                                          "category": "Senior Civil Servants-National Government",
                                          "title": "Presidential Aide for Special Missions",
                                          "fromDate": {
                                             "month": "01",
                                             "year": "2013"
                                          },
                                          "toDate": {
                                             "day": "21",
                                             "month": "01",
                                             "year": "2013"
                                          }
                                       },
                                       {
                                          "type": "Previous Roles",
                                          "category": "Senior Civil Servants-National Government",
                                          "title": "State Secretary, National Security Council",
                                          "fromDate": {
                                             "day": "05",
                                             "month": "08",
                                             "year": "1994"
                                          },
                                          "toDate": {
                                             "month": "10",
                                             "year": "1995"
                                          }
                                       },
                                       {
                                          "type": "Previous Roles",
                                          "category": "National Government Ministers",
                                          "title": "Minister of Interior",
                                          "fromDate": {
                                             "month": "10",
                                             "year": "1995"
                                          },
                                          "toDate": {
                                             "month": "12",
                                             "year": "1995"
                                          }
                                       },
                                       {
                                          "type": "Previous Roles",
                                          "category": "Senior Civil Servants-National Government",
                                          "title": "Head, Presidential Administration",
                                          "fromDate": {
                                             "month": "11",
                                             "year": "2004"
                                          },
                                          "toDate": {
                                             "day": "04",
                                             "month": "01",
                                             "year": "2006"
                                          }
                                       }
                                    ],
                                    "dates": [
                                       {
                                          "type": "Date of Birth",
                                          "date": {
                                             "day": "26",
                                             "month": "05",
                                             "year": "1958"
                                          }
                                       }
                                    ],
                                    "references": [
                                       {
                                          "source": "EC 2015/1949 Belarus List",
                                          "fromDate": {
                                             "day": "29",
                                             "month": "10",
                                             "year": "2015"
                                          }
                                       },
                                       {
                                          "source": "EC (CFSP) 2015/1957 Belarus List",
                                          "fromDate": {
                                             "day": "29",
                                             "month": "10",
                                             "year": "2015"
                                          }
                                       },
                                       {
                                          "source": "EC 2016/276 Belarus List",
                                          "fromDate": {
                                             "day": "25",
                                             "month": "02",
                                             "year": "2016"
                                          }
                                       },
                                       {
                                          "source": "EC (CFSP) 2016/280 Belarus List",
                                          "fromDate": {
                                             "day": "25",
                                             "month": "02",
                                             "year": "2016"
                                          }
                                       },
                                       {
                                          "source": "French Economy Ministry - EU and UN Asset Freezing Measures",
                                          "fromDate": {
                                             "day": "30",
                                             "month": "07",
                                             "year": "2017"
                                          }
                                       }
                                    ],
                                    "addresses": [
                                       {
                                          "line": "Karl Marx, 38",
                                          "city": "Minsk",
                                          "postalCode": "220016",
                                          "country": "BY"
                                       }
                                    ],
                                    "identifications": [
                                       {
                                          "type": "OFAC Program ID",
                                          "value": "BELARUS"
                                       },
                                       {
                                          "type": "OFAC Unique ID",
                                          "value": "9769"
                                       },
                                       {
                                          "type": "EU Sanctions Programme Indicator",
                                          "value": "BLR"
                                       },
                                       {
                                          "type": "EU Consolidated Electronic List ID",
                                          "value": "3411"
                                       },
                                       {
                                          "type": "HM Treasury Group ID",
                                          "value": "8904"
                                       },
                                       {
                                          "type": "SECO SSID",
                                          "value": "4596"
                                       }
                                    ],
                                    "images": [
                                       "https://naviny.com/c/b0/b06235bad25e89f92f5ffe89676e8589.jpg",
                                       "http://pmrb.gov.by/images/shejman.jpg"
                                    ],
                                    "classifications": {
                                       "pep": [
                                          "level2",
                                          "level1"
                                       ]
                                    }
                                 },
                                 "breakdown": [
                                    {
                                       "fieldName": "name",
                                       "riskWeight": 100,
                                       "breakdowns": [],
                                       "fieldValue": "viktor uladzimiravich sheyman",
                                       "score": 93,
                                       "riskWeightedScore": 93,
                                       "normalisedScore": 100
                                    }
                                 ]
                              }
                           ]
                        }
                    }
                }
            }
        ]
    }
}

Last updated