curl --request POST \
--url 'https://{{baseUrl}}/amlyze-ws-rest/customer' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"communicationNumber": "1b1e1c23-f62f-4338-90b9-8d54993dd2cd",
"requester": "SYSTEMX",
"businessUnit": "sandbox",
"sourceOfRiskLevel": "IMPORT",
"riskLevel": "HIGH",
"customerStatus": "ACTIVE",
"riskManagementCategory": "IND",
"entityType": "INDIVIDUAL",
"customerExtId": "IND_IMPORT_B1_TEST",
"applicationDate": "2016-01-01",
"firstName": "Lukas",
"lastName": "Garcia"
}
'{
"errorCode": "<string>",
"errorDescription": "<string>"
}Evaluate customer
To initiate the scoring process, the sourceOfRiskLevel field in the API payload must be set to EVALUATE. This instructs the AMLYZE engine to run the customer’s data through the active risk matrix. In contrast, sending the value IMPORT will only update the customer’s data in the system without triggering a new risk evaluation.
curl --request POST \
--url 'https://{{baseUrl}}/amlyze-ws-rest/customer' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"communicationNumber": "1b1e1c23-f62f-4338-90b9-8d54993dd2cd",
"requester": "SYSTEMX",
"businessUnit": "sandbox",
"sourceOfRiskLevel": "IMPORT",
"riskLevel": "HIGH",
"customerStatus": "ACTIVE",
"riskManagementCategory": "IND",
"entityType": "INDIVIDUAL",
"customerExtId": "IND_IMPORT_B1_TEST",
"applicationDate": "2016-01-01",
"firstName": "Lukas",
"lastName": "Garcia"
}
'{
"errorCode": "<string>",
"errorDescription": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Date when customer first applied.
Unique number of communication. It is used for risk assessment callback.
255Unique external customer identifier. This identifier corresponds to the client's identifier in the financial institution.
"019a5d1b-8c4f-770b-ad70-2f2a6c88aeda"
Type of the customer. INDIVIDUAL represents a natural person; ORGANIZATION represents a legal entity such as a company, partnership, or foundation.
❗ This value drives conditional field requirements:
INDIVIDUALrequiresfirstName,lastNameORGANIZATIONrequirestitle,registrationCountry,legalForm
Fields specific to the other entity type are not allowed. See each affected field's description for its individual constraint.
INDIVIDUAL, ORGANIZATION Name of the system requesting web service.
100Code of risk management category of the object. Value must be from a classifier list personalized to your company.
The value EVALUATE is used for initiating a customer risk assessment. The value IMPORT should be used for migration only - the customer and it's questionnaire will be imported without risk assessment.
EVALUATE, IMPORT 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 value is set as default.
❗ By UPDATEing, all data will be replaced with newly received one.
CREATE, UPDATE Description of entity activity.
32768Description of business entities' activities in a restricted region.
32768Whether the person is an AML officer.
Date of application approval - onboarding date.
Country of birth of individual entity.
Date of birth of individual entity.
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. Value is taken from /classifier/businessUnit endpoint.❗Mandatory field for clients utilizing a multi-organizational solution. Omit this parameter unless instructed about it.
255Country of citizenship of individual entity.
❗Mandatory only when customerStatus = CLOSED. Not used when customerStatus is PENDING, ACTIVE, REJECTED or SUSPENDED.
Value of the company's assets.
Customer's predefined status represents the current standing or state of a customer's relationship with a business or organization.
PENDING- Customer application is received but not yet prepared for upcoming workflowACTIVE- Customer is onboarded and ready for workflowREJECTED- the customer was rejected before account was openedSUSPENDED- Customer's activities for some reasons are restrictedCLOSED- Customer's profile is disabled
ACTIVE, CLOSED, PENDING, REJECTED, SUSPENDED Whether cash is the main income source.
Date of establishment of the organization.
Information about the activities.
Show child attributes
Show child attributes
First name of the individual.
❗ This field is mandatory when entityType is INDIVIDUAL.
Global intermediary identification number.
Whether the entity has a multi-layer organizational structure.
Description of income source.
32768Description of incoming payment operation.
Account of initial deposit.
200Initial deposit amount.
Bank of initial deposit.
200Initial deposit currency. Taken from /classifier/currency endpoint.
Source of initial deposit.
200Defines which lists to check during screening process.
SANCTIONS, PEP, ADVERSE_MEDIA, INTERNAL_LIST Whether entity's actual address is declared.
Whether the business entity is audited.
Whether entity's correspondence address is declared.
Whether entity is managed directly.
Whether a family member of the individual is politically exposed.
Whether entity is a financial institution.
Whether the business entity is fined.
Whether there is adverse-media information about the entity.
Whether there is internal-list information about the entity.
Whether the individual is a legal resident.
Whether the entity's activity requires a license.
Whether the business entity is listed on a stock exchange.
Whether the customer is involved in litigation.
Whether the entity is politically exposed.
Whether the business entity is regulated by third-party authorities.
Whether the entity is sanctioned.
Last name of the individual.
❗ This field is mandatory when entityType is INDIVIDUAL.
Legal form of the organization. Value taken from /classifier/legalForm endpoint.
❗ This field is mandatory when entityType is ORGANIZATION.
LEI stands for Legal Entity Identifier, which is a unique code used to identify legal entities that participate in financial transactions.
Business entities license description.
32768List of business activities.
Show child attributes
Show child attributes
List of additional custom fields, typed by datatype.
Show child attributes
Show child attributes
List of addresses.
Show child attributes
Show child attributes
List of appeal reasons.
Show child attributes
Show child attributes
List of business entity documents.
Show child attributes
Show child attributes
List of contacts.
Show child attributes
Show child attributes
List of activity countries.
Show child attributes
Show child attributes
List of countries where the customer pays tax.
Show child attributes
Show child attributes
List of declared turnover ranges.
Show child attributes
Show child attributes
List of customer income sources.
Show child attributes
Show child attributes
List of customer introduction sources.
Show child attributes
Show child attributes
List of services ordered by the customer.
Show child attributes
Show child attributes
List of countries involved in payment turnover.
Show child attributes
Show child attributes
List of payment purposes by turnover direction.
Show child attributes
Show child attributes
Indicates whether the entity is on a risk-management list.
WHITE- Entity is allow-listed.BLACK- Entity is block-listed.
BLACK, WHITE List of activity regions.
Show child attributes
Show child attributes
List of related business entities.
Show child attributes
Show child attributes
List of customer sources of wealth.
Show child attributes
Show child attributes
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.
100Whether entity has no major shareholders involved.
The number of times a business entity has been audited.
Number of employees.
Description of organizational structure.
32768Description of outgoing payment operation.
The number of years that are in question for being audited.
The number of years that are in question for being fined.
Country of permanent residence of individual entity.
Place of birth of individual entity.
Description of the region for activities.
32768Country of registration of the organization. Value taken from /classifier/country endpoint.
❗ This field is mandatory when entityType is ORGANIZATION.
Predefined risk level of imported customer.
EXTREME, HIGH, LOW, MEDIUM, NONE Country of second citizenship of individual entity.
Whether the entity uses third-party services.
Description of third-party services used by entity.
32768Title (official name) of the organization.
❗ This field is mandatory when entityType is ORGANIZATION.
Public-facing trading name of the organization, if different from its legal name. Allowed only when entityType is ORGANIZATION.