Column Name

Description

Data Type

Format/Example

Validation

Category

The action you are trying to achieve via the upload functionality (here: creating a new key party for a profile)

Text

keyparty

Mandatory. Acceptable values are profile/ keyparty/search/ profileDelete

Profile_id

Unique guid identifier generated by the system, for every profile created, utilized to add the keyparty to a profile

Alpha numeric

Optional.
Either of profile_id/profile_name/internal_id should be provided.

Profile_name

Refers to the name of the profile, the keyparty should be added to

Text

Creditsafe

Optional.
Either of profile_id/profile_name/internal_id should be provided.

Internal_id

Referring to the internal ID of the profile, the keyparty should be added to

Alpha numeric

Optional.
Either of profile_id/profile_name/internal_id should be provided.

Entity_type

Represents the type of entity being added i.e., business, or individual

Text

individual

Mandatory.
Acceptable values: business/individual

Full_name

The full or legal name of the key party, utilized to run AML Screening

Text

Mandatory (if first_name/last_name is not provided)
Max length is 150.

First_name

First name of the key party, utilized to run AML Screening

Text

Carys

Mandatory (if full_name is not provided)
Max length is 150.

Middle_name

Middle name of the key party, utilized to run AML Screening

Text

Wyn

Optional.
Max length is 150.

Last_name

Last name of the key party, utilized to run AML Screening

Text

Hughes

Mandatory (if full_name is not provided)
Max length is 150.

gender

Gender of the key party, utilized to run AML Screening

Text

female

Optional.
Acceptable values: male/female
entity_type must be “individual”

dob

A person’s date of birth, utilized to run AML Screening

Date

1981-03-01

Optional.
Acceptable format: yyyy-mm-dd
entity_type must be “individual”

Is_dob_required

To utilize DOB as a strict screening criterion for individuals

Text

True

Optional.
Acceptable value: yes/no/true/false
If no input is provided, it is set to “false”

Country_code

Country for the key party, utilized to run AML Screening

2-letter country code

GB

Optional.
Acceptable value is an ISO 3166-1 alpha-2 code

threshold

A score indicating the similarity between search parameters and potential AML Screening hits

Number

85

Optional.
Acceptable value: 75/80/85/90/95/100
If no input is provided, threshold is set at 90  

datasets

The specific types of information used to assess and monitor potential laundering risks

Text

SAN; DD; PEP

Optional.
If entity_type is “business,” acceptable values are SAN; ENF; INS; SOE; PEP; POI; AM. 

If entity_type is “individual,” acceptable values are SAN; ENF; INS; DD; PEP; POI; AM
If no input is provided, it is set to all values specified above.

Pep_tiers

Categorizations of Politically Exposed Persons (PEPs) based on their level of influence, prominence, or risk

Text

Optional.
Acceptable values are: pepTier1; pepTier2; pepTier3
entity_type should be “individual”

Optional. 

Acceptable values are 1-80. 

Details of sanctioning body and its ID can be found here  

Add_to_aml_screening

If the keyparty details provided must be screened against AML Categories

Text

true

Optional.
Acceptable value: yes/no/true/false
If no input is provided, it is set to “true”

Add_to_aml_monitoring

If the key party details provided must be monitored against AML Categories.

Text

true

Optional.
Acceptable value: yes/no/true/false
Cannot be set to “yes” or “true” if add_to_aml_screening is “no” or “false”
If no input is provided, it is set to “false”

Alerts_email_recipients

Email address to receive notifications for AML Alerts generated by keyparty

Text

test@test.com

Up to 5 email recipients can be added separated by semicolon

Assign_to

User ID of the person in your organisation you want to assign the screening results of the key party to

Number

123456789

Optional.

Key_party_type

Refers to the significant role the individual or company plays in the operation, management, or ownership of the business

Text

director

Mandatory.
Acceptable value: shareholder/director/ubo/other

Organisation_number

Represents the company’s Registration Number

Number

Optional.
Max length is 150.
Entity_type should be “business”

Activity_code

Refers to a standard industrial classification code that identifies a firm’s primary business activity, utilised to set the SIC/Activity for a company

Alpha numeric

82990

Optional.
Max length is 150.
Entity_type should be “business”

Building_details

The building name/number or line 1 of address for the keyparty

Text

CASPIAN POINT ONE

Optional.
Max length is 150.

street

The street name or line 1 of address for the keyparty

Text

PIERHEAD STREET

Optional.
Max length is 150.

city

The city/town or line 2 of address for the keyparty

Text

CARDIFF

Optional.
Max length is 150.

region

The region/state or line 2 of address for the keyparty

Text

Optional.
Max length is 150.

Address_country_code

The country address for the keyparty

Text

GB

Optional.

Postal_code

The zip/postal code for the keyparty

Text

CF10 4DQ

Optional.
Max length is 50.

Key_party_director_role

Refers to the role/designation/occupation of the person listed as a director in a company

Text

Chief Financial Officer

Optional.
Entity_type should be “individual”, and key_party_type should be “director”

Key_party_shareholder_shares%

Referring to the percentage of shares held by the person or company, listed as a key party for a business

Number

Optional.
key_party_type should be “shareholder.”

Acceptable value should be between 0 and 100