Customer import - Organization with risk assessment

This section provides information how to submit customer details to our database and is focused on organizations requiring risk assessment. It includes examples of API requests with mandatory and optional fields, a comprehensive list of all available fields, common responses, and error descriptions.

HTTP Method: POST

Path: {{baseUrl}}/amlyze-ws-rest/customer

ContentType: application/json

Authorization: Bearer Token

API requests examples

Show Mandatory fields example | CUSTOMER import - organization with risk assessment

{
  "communicationNumber": "Test_ComNr_003ZZZc",
  "requester": "Company Name Amlyze",
  "businessUnit": "sandbox",
  "sourceOfRiskLevel": "EVALUATE",
  "riskManagementCategory": "ORG",
  "entityType": "ORGANIZATION",
  "customerExtId": "ORG_IMPORT_B1_TEST",
  "applicationDate": "2024-04-08T10:45:00.000+02:00",
  "title": "LTD 'VivaElementus'",
  "registrationCountry": "LV",
  "legalForm": "CORPORATION"
}

Show Mandatory fields example | CUSTOMER import - organization with risk assessment and screening

{
 "communicationNumber": "Test_ComNr_003ZZZc",
  "requester": "Company Name Amlyze",
  "businessUnit": "sandbox",
  "sourceOfRiskLevel": "EVALUATE",
  "riskManagementCategory": "ORG",
  "entityType": "ORGANIZATION",
  "customerExtId": "ORG_IMPORT_B1_TEST",
  "applicationDate": "2024-04-08T10:45:00.000+02:00",
  "title": "LTD 'VivaElementus'",
  "registrationCountry": "LV",
  "legalForm": "CORPORATION"

  "initializeScreeningProcesses": [
      "SANCTIONS",
      "ADVERSE_MEDIA",
      "PEP",
      "INTERNAL_LIST"
  ]
}

Show All fields example | CUSTOMER import - organization with risk assessment

{
  "communicationNumber": "Test_ComNr_003ZZZD",
"requester": "Company Name Amlyze",
"businessUnit": "sandbox",
"action": "CREATE",
"sourceOfRiskLevel": "EVALUATE",
"customerStatus": "CLOSED",
"riskManagementCategory": "ORG",
"entityType": "ORGANIZATION",
"customerExtId": "ORG_C1_TEST",
"applicationDate": "2020-01-03",
"closingDate": "2023-09-08",
"title": "LTD 'MinorMajor'",
"registrationCountry": "LT",
"legalForm": "CORPORATION",
"initializeScreeningProcesses": [
	"SANCTIONS",
	"ADVERSE_MEDIA",
	"PEP",
	"INTERNAL_LIST"
],
"tradingName": "MinorMajor",
"approvalDate": "2020-01-05",
"establishmentDate": "2001-02-23",
"nationalCode": "REG74121101",
"activityDescription": "Logistics",
"activityInRestrictedRegionDescription": "Logistics",
"isPEP": false,
"isSanctioned": false,
"isInAdverseMedia": true,
"isInInternalList": true,
"giin": "GIIN123445",
"lei": "LEI124545",
"listPurpose": "BLACK",
"isActualAddressDeclared": true,
"isCorrespondenceAddressDeclared": false,
"incomeSourceDescription": "Salary",
"initialDepositSource": "Salary",
"initialDepositBank": "TBC",
"initialDepositAccount": "LT0089500500000070",
"initialDepositAmount": "10000",
"initialDepositCurrency": "EUR",
"doesCashDominate": true,
"isAudited": true,
"numberOfAudits": 6,
"periodsOfAuditsInYears": 3,
"organizationalStructureDescription": "Hierarchical",
"hasMultiLayerStructure": false,
"isFinancialInstitution": false,
"isDirectlyManaged": true,
"noMajorShareHolders": true,
"numberOfEmployees": 25,
"companyAssetValue": 100000,
"isFined": false,
"periodsOfFiningInYears": 3,
"isListed": false,
"isRegulated": false,
"isLicenseRequired": true,
"licenseDescription": "Licence No.4012",
"thirdPartyServicesUsed": true,
"thirdPartyServicesUsedDescription": "Hosting",
"regionOfActivityDescription": "Wester region",
"listContact": [
	{
		"contactType": "EMAIL",
		"contactDetails": "companyMail@gmail.com",
		"useForCommunication": true
	}
],
"listAddress": [
	{
		"addressType": "HEADQUARTERS",
		"addressDetails": "Verkiu g. 1-53, Vilnius",
		"country": "LT",
		"region": "EU",
		"city": "Vilnius",
		"streetAddress": "Verkiu g.",
		"zipCode": "04128",
		"useForCorrespondence": true
	}
],
"listBusinessEntityDocument": [
	{
		"entityType": "ORGANIZATION",
		"identityDocumentType": "OTHER",
		"documentNumber": "LK4545587741121",
		"documentIssueDate": "2020-01-03",
		"documentExpiryDate": "2030-01-03",
		"documentIssueCountry": "LT",
		"documentIssueAuthority": "Migration office",
		"description": "Main identification document"
	}
],
"listAppealReason": [
	{
		"appealReasonType": "BANKING"
	}
],
"listIntroductionSource": [
	{
		"introductionSource": "AGENT"
	}
],
"listOrderedService": [
	{
		"serviceType": "LOANS"
	}
],
"listDeclaredTurnover": [
	{
		"turnoverType": "ANNUAL_TURNOVER",
		"turnoverRange": "MONTHLY",
		"from": 1000,
		"to": 2000
	}
],
"listIncomeSource": [
	{
		"incomeSourceType": "ADULT",
		"incomePercentage": 95,
		"from": 2000,
		"to": 2200
	}
],
"listPaymentPurpose": [
	{
		"turnoverDirection": "OUT",
		"paymentPurposeType": "RENT_AND_UTILITIES"
	},
	{
		"turnoverDirection": "IN",
		"paymentPurposeType": "MARKETING_SERVICES"
	}
],
"listSourceOfWealth": [
	{
		"code": "ADULT",
		"amount": 100000,
		"comment": "Wealth from inheritance"
	}
],
"listPaymentCountry": [
	{
		"country": "LT",
		"turnoverDirection": "IN"
	},
	{
		"country": "LV",
		"turnoverDirection": "OUT"
	}
],
"listActivity": [
	{
		"activityType": "NACE_A",
		"incomePercentage": 15
	}
],
"listRegionOfActivity": [
	{
		"region": "EU"
	}
],
"listCountryOfActivity": [
	{
		"country": "LT"
	},
	{
		"country": "LV"
	}
],
"listCountryOfTaxPayment": [
	{
		"country": "LV",
		"taxpayerNumber": "5541245574"
	}
],
"listAdditionalValues": [
	{
		"code": "relation_usa",
		"description": "Entity related to USA?",
		"datatype": "BOOLEAN",
		"value": true
	}
],
"listRelatedEntity": [
	{
		"entityType": "ORGANIZATION",
		"relationType": "BOARD_MEMBER",
		"relationDescription": "Founder",
		"extId": "Rel_entity_ExtID_4052",
		"share": 10,
		"votePercentage": 10,
		"activityDescription": "Financial activity",
		"regionOfActivityDescription": "Eastern Europe",
		"nationalCode": "554555447884557",
		"country": "LT",
		"registrationCountry": "LT",
		"isPEP": true,
		"isSanctioned": true,
		"isInAdverseMedia": true,
		"isInInternalList": true,
		"title": "LTD 'Fokusmano'",
		"legalForm": "CORPORATION",
		"establishmentDate": "1998-04-07",
		"listContact": [
			{
				"contactType": "EMAIL",
				"contactDetails": "Karuna.info@gmail.com",
				"useForCommunication": true
			}
		],
		"listAddress": [
			{
				"addressType": "HEADQUARTERS",
				"addressDetails": "Panemunių g. 15-4",
				"country": "LT",
				"region": "EU",
				"city": "Vilnius",
				"streetAddress": "Panemunių g.",
				"zipCode": "048715",
				"useForCorrespondence": true
			}
		],
		"listBusinessEntityDocument": [
			{
				"entityType": "ORGANIZATION",
				"identityDocumentType": "REGISTRATIONCERTIFICATE",
				"documentNumber": "LT-4574551121",
				"documentIssueDate": "2015-01-03",
				"documentExpiryDate": "2025-01-03",
				"documentIssueCountry": "LT",
				"documentIssueAuthority": "VMI",
				"description": "Certificate of Registration"
			}
		],
		"listIncomeSource": [
			{
				"incomeSourceType": "ADULT",
				"incomePercentage": 10,
				"from": 10,
				"to": 100
			}
		],
		"listActivity": [
			{
				"activityType": "NACE_A",
				"incomePercentage": 50
			}
		],
		"listRegionOfActivity": [
			{
				"region": "EU"
			}
		],
		"listCountryOfActivity": [
			{
				"country": "LV"
			}
		],
		"listAdditionalValues": [
			{
				"code": "identity_verification_passed",
				"description": "Verification has been passed?",
				"datatype": "BOOLEAN",
				"value": "true"
			}
		]
	}
]
}

Fields

communicationNumber

string

required

Unique number of communication. It is used for risk assessment callback. This field can store up to 256 characters.

Example: Test_ComNr_002mHzZZ

requester

string

required

Name of the system requesting web service.

Example: Amlyze

businessUnit

string from classifier list

❗Mandatory field for clients utilizing a multi-organizational solution. Omit this parameter unless instructed about it.

It serves to specify the unique identifier for the business unit. Business units are logical groupings of users and data. Each business unit can have its own set of users, permissions, and data access rules.

Example: BUSINESS_UNIT_NAME

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/businessUnit

action

string from enum

Element is used to indicate whether a client needs to be created or the existing customer’s data to be updated. As this field is not mandatory and if not provided, CREATE values is set as default.

❗ By UPDATEing, all data will be replaced with newly received one

Enum class values: CREATE, UPDATE

Example: UPDATE

sourceOfRiskLevel

string

required

The value EVALUATE is used for initiating a customer risk assessment.

Value: EVALUATE

customerStatus

string from enum

required

Customer’s predefined status represents the current standing or state of a customer’s relationship with a business or organization

Enum class values: PENDING, ACTIVE, REJECTED, SUSPENDED, CLOSED

PENDING - Customer application is received but not yet prepared for upcoming workflow

ACTIVE - Customer is onboarded and ready for workflow

REJECTED- the customer for some reasons was rejected before opening an account for him

SUSPENDED - Customer’s activities for some reasons are restricted

CLOSED - Customer’s profile is disabled

Example: ACTIVE

riskManagementCategory

string from classifier list

required

Code of risk management category of the object. Value must be from a classifier list personalized to your company.

Example: ORG

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/riskManagementCategory

entityType

string

required

Notifies about customer type.

Value: ORGANIZATION

customerExtId

string

required

Unique external customer identifier. This identifier corresponds to the client’s identifier in the financial institution.

Example: cust_1232

applicationDate

date

required

Date when customer first applied.

Example: 2020-01-03

closingDate

date

❗Mandatory only when customerStatus = CLOSED. Not used when customerStatus is PENDING, ACTIVE, REJECTED or SUSPENDED.

Example: 2005-05-24

title

string

required

Title of the organization entity.

Example: LTD 'MinorMajor'

registrationCountry

string (ISO 3166-1 alpha-2) from classifier list

required

Country of registration of the organization.

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/country

Example: LT

legalForm

string from classifier list

required

Legal form of the organization.

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/legalForm

Example: LTD

initializeScreeningProcesses

list[]

Defines which lists to check during screening process. Strings of the list are noted in the dropdown below.

Show list[]

   "initializeScreeningProcesses": [
       "SANCTIONS",
       "PEP",
       "ADVERSE_MEDIA",
       "INTERNAL_LIST"
   ]

Example: PEP, ADVERSE_MEDIA

tradingName

string

Trading name of the organization.

Example: MinorMajor

approvalDate

date

Date of application approval - onboarding date.

Example: 2020-01-05

establishmentDate

date

Establishment date for organization type entities.

Example: 2001-02-23

nationalCode

string

National code or national identification number of individual. If a country does not issue national code, any other unique identifier can be used:

Passport number
Social security number of person
A number of taxpayer or registration certificate of the company, etc
A number of taxpayer or registration certificate of the company

Example: 50001010022

activityDescription

string

Description of entity activity.

Value: Logistics

activityInRestrictedRegionDescription

string

Description of business entities’ activities in a restricted region.

Value: Logistics

isPEP

boolean

Identification for whether a person is politically exposed.

Example: true

isSanctioned

boolean

Identification for whether a person is sanctioned.

Example: false

isInAdverseMedia

boolean

An indication of the existence of information on adverse media about the entity.

Example: true

isInInternalList

boolean

An indication of the existence of information on internal list about the entity.

Example: true

giin

string

Global intermediary identification number.

Example: GIN548745122

lei

string

LEI stands for Legal Entity Identifier, which is a unique code used to identify legal entities that participate in financial transactions.

Example: LEI54511548

listPurpose

string from enum

Indicator whether entity is white/black listed.

Enum class values: WHITE, BLACK

Example: WHITE

isActualAddressDeclared

boolean

Indicator for actual address declaration.

Example: true

isCorrespondenceAddressDeclared

boolean

Indicator for actual address declaration.

Example: false

incomeSourceDescription

string

Description of income source of the entity.

Example: Job salary

initialDepositSource

string

Source of initial deposit.

Example: Salary

initialDepositBank

string

Bank of the initial deposit

Example: TBC

initialDepositAccount

string

Account of initial deposit

Example: LT0089500500000070

initialDepositAmount

double

Amount of initial deposit.

Example: 8500.48

initialDepositCurrency

string from classifier list

This currency field notifies about initial deposit currency.

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/currency

Example: EUR

doesCashDominate

boolean

Indicator for cash being the main income source.

Example: true

isAudited

boolean

Indicator for the business entity being audited.

Example: true

numberOfAudits

integer

The number of times a business entity has been audited

Example: 3

periodsOfAuditsInYears

integer

The number of years that are in question for being audited.

Example: 1

organizationalStructureDescription

string

Description of organization structure.

Example: Hierarchical

hasMultiLayerStructure

boolean

Check for multi-layer organizational structure.

Example: true

isFinancialInstitution

boolean

Whether entity is financial institution.

Example: true

isDirectlyManaged

boolean

Whether entity is managed directly.

Example: false

Whether entity has no major shareholders involved.

Example: false

numberOfEmployees

integer

The number of employees in the company.

Example: 25

companyAssetValue

integer

Value of companies assets.

Example: 100000

isFined

boolean

Whether entity has fines.

Example: false

periodsOfFiningInYears

integer

The number of years that are in question for being fined.

Example: 3

isListed

boolean

Indicator for the business entity is listed in stock exchange companies.

Example: false

isRegulated

boolean

Indicator for the business entity being regulated by third-party authorities.

Example: false

isLicenseRequired

boolean

Whether entity activity requires license.

Example: false

licenseDescription

string

Business entities license description.

Example: Licence No.4012

thirdPartyServicesUsed

string

Whether client is using third party services.

Example: true

thirdPartyServicesUsedDescription

string

Description of third party services.

Example: Hosting

regionOfActivityDescription

string

Description of the region for activities.

Example: Customer service

listContact

list[]

Show listContact list[] fields

contactType

string from enum

required

Way of contacting entity. This field is not mandatory if listContact field is not provided at all.

Enum class values: MOBILEPHONE, FIXEDPHONE, EMAIL, WEBSITE

Example: MOBILEPHONE

contactDetails

string

required

Details of contact. This field is not mandatory if listContact field is not provided at all.

Examples: 868758585, hello@gmail.com, www.website.com

useForCommunication

boolean

Indicator for the usage of communication way.

Example: true

listAddress

list[]

Show listAddress list[] fields

addressType

string from classifier list

Type of entity address.

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/addressType

Example: RESIDENCE

addressDetails

string

Full address description.

Example: Building B

Country

string (ISO 3166-1 alpha-2) from classifier list

required

Country of the given address. This field is not mandatory if listAddress field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/country

Example: LT

region

string

Region of the given address.

Example: EU

city

string

City of the given address.

Example: Vilnius

streetAddress

string

Street, house, and flat number of the given address.

Example: Verkių g. 1-9

zipCode

string

Zip code of the address.

Example: 12345

useForCorrespondence

boolean

Indicator for using the address in correspondence.

Example: true

listBusinessEntityDocument

list[]

Show listBusinessEntityDocument list[] fields

entityType

string

required

Entity type describes the client status. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Value: INDIVIDUAL

identityDocumentType

string from enum

required

Identification document type. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Enum class values: PASSPORT, IDENTITYCARD, RESIDENCEPERMIT, DRIVINGLICENSE, REGISTRATIONCERTIFICATE, OTHER

Example: PASSPORT

documentNumber

string

required

The number of the document in question. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Example: 0123456789

documentIssueDate

date

required

The issue date of the document in question. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Example: 2022-01-15

documentExpiryDate

date

The expiry date of the document in question.

Example: 2032-01-15

documentIssueCountry

string (ISO 3166-1 alpha-2)

required

The country that issued the document. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/country

Example: LT

documentIssueAuthority

string

required

An authority that issued the document. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Example: Migration office

description

string

Document description.

Example: passport

listAppealReason

list[]

Show listAppealReason list[] fields

appealReasonType

string from classifier list

required

Appeal reason type. This field is not mandatory if listAppealReason field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/appealReasonType

Example: PRICING

listIntroductionSource

list[]

Show listIntroductionSource list[] fields

introductionSource

string from classifier list

required

Introduction source. This field is not mandatory if listIntroductionSource field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/introductionSourceType

Examples: INTERNET, INTRODUCER

listOrderedService

list[]

Show listOrderedService list[] fields

serviceType

string from classifier list

required

Service type. This field is not mandatory if listOrderedService field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/serviceType

Examples: LOANS, DEPOSITS

listDeclaredTurnover

list[]

Show listDeclaredTurnover list[] fields

turnoverType

string from classifier list

required

Type of declared turnover.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/turnoverType

Example: TURNOVER_PER_MONTH

turnoverRange

string from enum

required

Range of declared turnover.

Enum class values: SINGLE, DAILY, MONTHLY, ANNUAL

Example: MONTHLY

from

integer

required

Amount range from. This field is not mandatory if listDeclaredTurnover field is not provided at all or to field is provided.

Example: 1000

integer

required

Amount range to. At least one value (from or to) must be specified. This field is not mandatory if listDeclaredTurnover field is not provided at all or to field is provided.

Example: 5000

listIncomeSource

list[]

Show listIncomeSource list[] fields

incomeSourceType

string from classifier list

required

Type of income source.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/incomeSourceType

Example: SALARY

incomePercentage

integer

required

Percentage of income from the source.

Example: 5

from

integer

Amount from.

Example: 100

integer

Amount to.

Example: 1000

listPaymentPurpose

list[]

Show listPaymentPurpose list[] fields

turnoverDirection

string from enum

required

Direction of payment turnover. This field is not mandatory if paymentPurposeType field is not provided at all.

Enum class values: IN, OUT

Example: OUT

paymentPurposeType

string from classifier list

required

Type of payment purpose. This field is not mandatory if paymentPurposeType field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/paymentPurposeType

Example: TAXES

listSourceOfWealth

list[]

Show listSourceOfWealth list[] fields

code

string from classifier list

required

Source of wealth code. This field is not mandatory if listSourceOfWealth field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/sourceOfWealth

Example: INHERITANCE

amount

decimal

Collected monetary amount.

Example: 100000

comment

string

Additional details about the source of wealth.

Example: text

listPaymentCountry

list[]

Show listPaymentCountry list[] fields

Country

string (ISO 3166-1 alpha-2) from classifier list

required

Country code. This field is not mandatory if listPaymentCountry field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/country

Example: US

turnoverDirection

string from enum

required

Direction of payment turnover. This field is not mandatory if listPaymentCountry field is not provided at all.

Enum class values: IN, OUT

Example: OUT

listActivity

list[]

Show listActivity list[] fields

activityType

string from classifier list

required

Type of business activity. This field is not mandatory if listActivity field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/activityType

Example: ACTIVITY_OTHER

incomePercentage

integer

Percentage of income from this activity.

Example: 15

listRegionOfActivity

list[]

Show listRegionOfActivity list[] fields

region

string from classifier list

required

Region where the activity takes place. This field is not mandatory if region field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/country

Examples: AU, EU

listCountryOfActivity

list[]

Show listCountryOfActivity list[] fields

Country

string (ISO 3166-1 alpha-2) from classifier list

required

Country where the activity takes place. This field is mandatory.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/country

Example: US, LT

listCountryOfTaxPayment

list[]

Show listCountryOfTaxPayment list[] fields

Country

string (ISO 3166-1 alpha-2) from classifier list

required

Country where the tax payment is made. This field is not mandatory if listCountryOfTaxPayment field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/country

Example: LT

taxpayerNumber

string

The tax identification number of the taxpayer.

Example: 5541245574

listAdditionalValues

list[]

Show listAdditionalValue list[] fields

code

string

required

Identifier for the additional field. This field is not mandatory if listAdditionalValue field is not provided at all.

Example: related_to_usa

description

string

required

Human readable description of the field. This field is not mandatory if listAdditionalValue field is not provided at all.

Example: Entity has relation to USA

datatype

string from enum

required

Type of provided value. This field is not mandatory if listAdditionalValue field is not provided at all.

Enum class values: STRING, INTEGER, DECIMAL, DATE, TIMESTAMP, BOOLEAN

Example: STRING

value

string

required

Value of the field. This field is not mandatory if listAdditionalValue field is not provided at all.

Example: true

List for related business entities. Fields of the list are described in the dropdown below.

Show listRelatedEntity list[] fields

customerExtId

string

Fill when related entity is also a customer in Amlyze. Example: ind1234567

entityType

string from enum

required

Type of entity describing client status. This field is not mandatory if listRelatedEntity field is not provided at all.

Enum class values: INDIVIDUAL, ORGANIZATION

Example: INDIVIDUAL

relationType

string from classifier list

required

Type of relationship between entities. This field is not mandatory if listRelatedEntity field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/relationType

Example: OWNER

relationDescription

string

Description of the relationship between entities.

Example: Founder

extId

string

Identifier used for screening callbacks to identify the entity.

Example: Related_extID_000

Shares owned by shareholders in the organization of the business entity.

Example: 75

votePercentage

integer

Vote percentage of shareholders in the organization of the business entity.

Example: 99

activityDescription

string

Activity description of the related entity.

Example: Financial activity

regionOfActivityDescription

string

Description of the activity region of the related entity.

Example: EU

nationalCode

string

National code or national identification number of the individual or organization.

Example: 123456789

Country

string (ISO 3166-1 alpha-2) from classifier list

If entityType is INDIVIDUAL, the country refers to the citizenship of the individual. If entityType is ORGANIZATION, the country refers to the country of registration of the organization.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/country

Example: LT

birthCountry

string (ISO 3166-1 alpha-2) from classifier list

Birth country of the related entity. This field applies when when entityType is INDIVIDUAL.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/country

Example: LT

isPEP

boolean

Indicator if the related individual entity is a politically exposed person.

Example: false

isSanctioned

boolean

Indicator if sanctions are applied to the entity.

Example: false

isInAdverseMedia

boolean

Indicator if there is information for an adverse media entity.

Example: false

isInInternalList

boolean

Indicator if there is information for an internal list entity.

Example: false

firstName

string

❗This field is mandatory when entityType is INDIVIDUAL.

First name of the related entity.

Example: John

lastName

string

❗This field is mandatory when entityType is INDIVIDUAL.

Last name of the related entity.

Example: Rodriguez

title

string

❗This field is mandatory when entityType is ORGANIZATION.

Title of the related entity.

Example: Dunder Mifflin

legalForm

string from classifier list

Legal form of the organization.

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/legalForm

Example: LTD

birthDate

date

Birth date of the related individual entity.

Example: 2000-05-28

establishmentDate

date

Establishment date of the related organization entity.

Example: 2000-05-28

listContact

list of ContactApi

listContact

list[]

List for contacts. Fields of the list are described in the dropdown below.

Show listContact list[] fields

contactType

string from enum

required

Way of contacting entity. This field is not mandatory if listContact field is not provided at all.

Enum class values: MOBILEPHONE, FIXEDPHONE, EMAIL, WEBSITE

Example: MOBILEPHONE

contactDetails

string

required

Details of contact. This field is not mandatory if listContact field is not provided at all.

Examples: 868758585, hello@gmail.com, www.website.com

useForCommunication

boolean

Indicator for the usage of communication way.

Example: true

listAddress

list[]

List of addresses. Fields of the list are described in the dropdown below.

Show listAddress list[] fields

addressType

string from classifier list

Type of entity address.

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/addressType

Example: RESIDENCE

addressDetails

string

Full address description.

Example: Building B

Country

string (ISO 3166-1 alpha-2) from classifier list

required

Country of the given address. This field is not mandatory if listAddress field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/country

Example: LT

region

string

Region of the given address.

Example: EU

city

string

City of the given address.

Example: Vilnius

streetAddress

string

Street, house, and flat number of the given address.

Example: Verkių g. 1-9

zipCode

string

Zip code of the address.

Example: 12345

useForCorrespondence

boolean

Indicator for using the address in correspondence.

Example: true

listBusinessEntityDocument

list[]

List of related entity documents. Fields of the list are described in the dropdown below.

Show listBusinessEntityDocument list[] fields

entityType

string

required

Entity type describes the client status. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Value: INDIVIDUAL

identityDocumentType

string from enum

required

Identification document type. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Enum class values: PASSPORT, IDENTITYCARD, RESIDENCEPERMIT, DRIVINGLICENSE, REGISTRATIONCERTIFICATE, OTHER

Example: PASSPORT

documentNumber

string

required

The number of the document in question. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Example: 0123456789

documentIssueDate

date

required

The issue date of the document in question. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Example: 2022-01-15

documentExpiryDate

date

The expiry date of the document in question.

Example: 2032-01-15

documentIssueCountry

string (ISO 3166-1 alpha-2)

required

The country that issued the document. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET

Path: {{baseUrl}}/classifier/country

Example: LT

documentIssueAuthority

string

required

An authority that issued the document. This field is not mandatory if listBusinessEntityDocument field is not provided at all.

Example: Migration office

description

string

Document description.

Example: passport

listIncomeSource

list[]

List of income sources. Fields of the list are described in the dropdown below.

Show listIncomeSource list[] fields

incomeSourceType

string from classifier list

required

Type of income source.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/incomeSourceType

Example: SALARY

incomePercentage

integer

required

Percentage of income from the source.

Example: 5

from

integer

Amount from.

Example: 100

integer

Amount to.

Example: 1000

listActivity

list[]

List of activities. Fields of the list are described in the dropdown below.

Show listActivity list[] fields

activityType

string from classifier list

required

Type of business activity. This field is not mandatory if listActivity field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/activityType

Example: ACTIVITY_OTHER

incomePercentage

integer

Percentage of income from this activity.

Example: 15

listRegionOfActivity

list[]

List of activity countries of related entity. Fields of the list are described in the dropdown below.

Show listRegionOfActivity list[] fields

region

string (ISO 3166-1 alpha-2) from classifier list

required

Region where the activity takes place. This field is not mandatory if region field is not provided at all.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/country

Examples: AU, EU

listCountryOfActivity

list[]

List of activity regions. Fields of the list are described in the dropdown below.

Show listCountryOfActivity list[] fields

Country

string (ISO 3166-1 alpha-2) from classifier list

required

Country where the activity takes place. This field is mandatory.

Show Path to extract classifier values

HTTP Method: GET
Path: {{baseUrl}}/classifier/country

Example: US, LT

listAdditionalValue

list[]

Additional information about customer. Fields of the list are described in the dropdown below. This list can be used to provide data, e.g. relation to Lithuania. The provided classification codes must be unique for one client or related entity and apply to all clients in the same way.

Show listAdditionalValue list[] fields

code

string

required

Identifier for the additional field. This field is not mandatory if listAdditionalValue field is not provided at all.

Example: related_to_usa

description

string

required

Human readable description of the field. This field is not mandatory if listAdditionalValue field is not provided at all.

Example: Entity has relation to USA

datatype

string from enum

required

Type of provided value. This field is not mandatory if listAdditionalValue field is not provided at all.

Enum class values: STRING, INTEGER, DECIMAL, DATE, TIMESTAMP, BOOLEAN

Example: STRING

value

string

required

Value of the field. This field is not mandatory if listAdditionalValue field is not provided at all.

Example: true

List of possible responses

This part lists common responses after the submission of the request.

200 OK
  "resultType": "REQUEST_ACCEPTED"


400 Bad Request
    "resultType": "REQUEST_REJECTED",
    "errorCode": "O001",
    "errorDescription": "CommunicationNumber already used in amlyze"


404 Not Found
    "timestamp": "2024-05-26T16:49:50.237+00:00",
    "status": 404,
    "error": "Not Found",
    "path": "/amlyze-ws-rest/customerr" --> mistake inside the endpoint


500 Internal Server Error
  "resultType": "REQUEST_REJECTED"
  "status": 500,
  "error": "Internal Server Error"

List of possible errors

This section lists the possible errors that can occur when making a bad customer request to the API. A bad request is a request that somehow does not follow the API specifications.

Error Code	Error Description
	ActivityType is mandatory
	ActivityType must be defined in Amlyze
	AddressType is mandatory.
	AddressType is not defined in Amlyze.
	Country is mandatory and can’t be empty
	Country is mandatory and must exist in Amlyze
	AdditionalValue.Code is mandatory
	AdditionalValue.Description is mandatory
	AdditionalValue.Value is mandatory
	AdditionalValue.Datatype is mandatory
	Duplicate code in additionalValues
	Bad datatype valueCode:
	Bad value for valueCode:
	Bad value for (format: ‘yyyy-MM-dd’) valueCode:
	Bad value for (format: ‘yyyy-MM-dd HH:mm:ss.SSSZ’) valueCode:
	Bad value for (values: true false’) valueCode:
	EntityType is mandatory. values: INDIVIDUAL, ORGANIZATION
	DocumentNumber is mandatory.
	DocumentIssueDate is mandatory.
	DocumentIssueCountry is mandatory and must exist in Amlyze
	DocumentIssueAuthority is mandatory
	CustomerExtId is mandatory.
	DELETE not yet implemented, contact Amlyze support
	Customer already exists
C004	Cannot update not existing customer, use Action = CREATE
	Requester is mandatory.
	RiskManagementCategory is mandatory.
C007	RiskManagementCategory does not exist in Amlyze
	Given RiskManagementCategory not supported for Customer
	SourceOfRiskLevel is mandatory. Values: IMPORT, EVALUATE
	Cannot demote existing customer to Lead riskManagementCategory
	EntityType is mandatory.
	When importing, CustomerStatus is mandatory.
C008.I02	When source of risk level IMPORT. ‘Lead’ risk management category is forbidden
	When source of risk level IMPORT. RiskLevel is mandatory, values: NONE, LOW, MEDIUM, HIGH, EXTREME
	When source of risk level EVALUATE. RiskLevel can’t be provided
C012	ApplicationDate is mandatory
C013	ClosingDate is mandatory for CLOSED CustomerStatus
C013a	ClosingDate can not exist for not CLOSED CustomerStatus
	Field not allowed for INDIVIDUAL. Field:
	For INDIVIDUAL type customer
	Field not allowed for ORGANIZATION. Field:
	For ORGANIZATION type customer
C016.I06	Problem with field for INDIVIDUAL type customer. CitizenshipCountry not found in amlyze
	InitialDepositCurrency not found in amlyze
C016.I06	BirthCountry not defined in Amlyze
	CitizenshipCountry not defined in Amlyze
C016.I08	SecondCitizenshipCountry not defined in Amlyze
C016.I08	PermanentResidenceCountry not defined in Amlyze
	Problem with field for INDIVIDUAL type customer.
FOA01	FieldOfActivity.Student.Country is invalid
FOA02	PensionCountry is invalid
	registrationCountry is invalid
REG	registrationCountry must exist in Amlyze
	LegalForm must exist in Amlyze
	Problem with field for ORGANIZATION type customer.
	TurnoverType is mandatory
	TurnoverType must exist in amlyze
	At least one value must be specified (FROM, TO)
	Problem with DeclaredTurnover (index: ).
	PaymentPurposeType does not exist in Amlyze
	TurnoverDirection is invalid
	Problem with PaymentPurpose (index: ).
	ServiceType not found in Amlyze
	Problem with OrderedService (index: ).
	Problem with Customer Contact index = .
	Problem with Customer BusinessEntityDocument index = .
	Problem with relatedEntity (index: ).
	Problem with relatedEntities.
	Problem with Address (index: ).
	screening process is undefined:
	PaymentCountry can’t be empty
	PaymentCountry not found in Amlyze
	TurnoverDirection is invalid
	Problem with PaymentCountry (index: ).
	IntroductionSource not found in amlyze
	Problem with IntroductionSource (index: ).
	Problem with IncomeSource (index: ).
	AppealReasonType is mandatory and can’t be empty
	AppealReasonType is mandatory and must be defined in Amlyze
	Problem with ListAppealReason (index: ).
	Problem with activity (index: ).
	Problem with RegionOfActivity (index: ).
	CountryOfTaxPayment can’t be empty
	CountryOfTaxPayment not found in Amlyze
	CountryOfTaxPayment (index: ).
	Problem with CountryOfActivity (index: ).
	Title is mandatory
	RegistrationCountry is mandatory
	LegalForm is mandatory
	FirstName is mandatory
	LastName is mandatory
AV07	Bad value for TIMESTAMP (format: ‘yyyy-MM-dd HH:mm:ss.SSSZ’) valueCode: lastonlinesupport
C014	Field not allowed for INDIVIDUAL. Field: CompanyAssetValue
C016.I06	Problem with field for INDIVIDUAL type customer. CitizenshipCountry not found in amlyze
C008.I02	When source of risk level IMPORT. ‘Lead’ risk management category is forbidden
C015	Field not allowed for ORGANIZATION. Field: LastName
SCR01	Screening process is undefined: NOT_EXISTS
Q004.ADR02	Problem with Address (index: 0 ). Country is mandatory and must exist in Amlyze
C015	Field not allowed for ORGANIZATION. Field: SecondCitizenshipCountry
C017.C016.RE01	Problem with field for ORGANIZATION type customer. Problem with relatedEntity (index: 0 ). Relation type is mandatory
Q014.RC01	Problem with PaymentCountry (index: 0 ). PaymentCountry not found in Amlyze
C014	Field not allowed for INDIVIDUAL. Field: NumberOfEmployees
AV07	Bad value for BOOLEAN (values: true false’) valueCode: isvip
C012	ApplicationDate is mandatory
C002	CustomerExtId is mandatory
Q002.DOC06	Problem with Customer BusinessEntityDocument index = 0 . DocumentIssueCountry is mandatory and must exist in Amlyze
Q017.COTP01	CountryOfTaxPayment (index: 0 ). CountryOfTaxPayment not found in Amlyze
C007	RiskManagementCategory does not exist in Amlyze
C014	Field not allowed for INDIVIDUAL. Field: LicenseDescription
C014	Field not allowed for INDIVIDUAL. Field: NumberOfAudits
C015	Field not allowed for ORGANIZATION. Field: FirstName
Q017.COTP01	CountryOfTaxPayment (index: 0 ). CountryOfTaxPayment not found in Amlyze
C016.I08	PermanentResidenceCountry not defined in Amlyze
FOA02	PensionCountry is invalid
C014	Field not allowed for INDIVIDUAL. Field: RegionOfActivityDescription
C016.I06	BirthCountry not defined in Amlyze
C013a	ClosingDate can not exist for not CLOSED CustomerStatus
C013	ClosingDate is mandatory for CLOSED CustomerStatus
C017.C016.RE08.DOC01	Problem with field for ORGANIZATION type customer. Problem with relatedEntity (index: 0 ). Problem with BusinessEntityDocuments (index: 0 ). EntityType is mandatory. values : INDIVIDUAL, ORGANIZATION
C017.C016.RE06.Co2	Problem with field for ORGANIZATION type customer. Problem with relatedEntity (index: 0 ). Problem with Contact (index: 0 ). ContactDetails is mandatory
C014	Field not allowed for INDIVIDUAL. Field: Title
AV07	Bad value for INTEGER valueCode: number_users
C017.O01	For ORGANIZATION type customer Title is mandatory
C010	EntityType is mandatory
C015	Field not allowed for ORGANIZATION. Field: PermanentResidenceCountry
C014	Field not allowed for INDIVIDUAL. Field: LegalForm
C014	Field not allowed for INDIVIDUAL. Field: ThirdPartyServicesUsedDescription
C015	Field not allowed for ORGANIZATION. Field: BirthCountry
C014	Field not allowed for INDIVIDUAL. Field: GIIN
C017.C016.RE01	Problem with field for ORGANIZATION type customer. Problem with relatedEntity (index: 0 ). Relation type is not defined in Amlyze
C004	Cannot update not existing customer, use Action = CREATE
C017.C016.RE03	Problem with field for ORGANIZATION type customer. Problem with relatedEntity (index: 0 ). Country not defined in Amlyze
C017.C016.RE02	Problem with field for ORGANIZATION type customer. Problem with relatedEntity (index: 0 ). EntityType is mandatory
REG	RegistrationCountry must exist in Amlyze
C017.C016.RE06.Co1	Problem with field for ORGANIZATION type customer. Problem with relatedEntity (index: 0 ). Problem with Contact (index: 0 ). ContactType is mandatory. values: MOBILEPHONE, FIXEDPHONE, EMAIL, WEBSITE
C014	Field not allowed for INDIVIDUAL. Field: EstablishmentDate
C014	Field not allowed for INDIVIDUAL. Field: PeriodsOfAuditsInYears
C017.C016.AV07	Problem with field for ORGANIZATION type customer. Problem with relatedEntity (index: 1 ). bad value for BOOLEAN (values: true false’) valueCode: is_related_to_Lithuania
C014	Field not allowed for INDIVIDUAL. Field: OrganizationalStructureDescription
C007	RiskManagementCategory is mandatory
	Problem with field for ORGANIZATION type customer.

API Documentation

​API requests examples

​Fields

​List of possible responses

​List of possible errors

API requests examples

Fields

List of possible responses

List of possible errors