Implementation manual for client communication with the web service.

Version	Date	Description
1.0.1	2026-01-18	Initial Release of AML Api

1. Introduction

AMLApi Service allows LIH systems to be compliant with the Anti-Money Laundering EU / RO legislations.

It provides several endpoints to generate the Real Beneficiary document, search for sanctions, get alerts on big value insurance premiums, fill the AML questionnaire.

2. Beneficiary Declaration

Endpoint: /beneficiaries/declaration/beneficiaries/declaration

Parameter	Type	Required	Description	Validation Rules
storeInDatabase	boolean	No	Set to false if you do not have to persist changes in DB regarding real beneficiaries
declarationDate	date	Yes	Date of the declaration	Accepted format: YYYY-MM-DD
companyName	string	Yes	Name of the company
companyRegNo	string	Yes
companyCui	string	Yes
repFirstName	string	Yes
repLastName	string	Yes
repIdSeries	string	No
repIdNumber	string	No
repCnp	string	Yes		CNP to be a valid romanian CNP
repSignature	string	No	In case the declaration is digitally signed via SMS code, send the valid code in this field.
beneficialOwners	Array of beneficialOwners object	Yes		At leas 1 object is needed in order to validate the request

BeneficialOwners Object

Parameter	Type	Required	Description	Validation Rules
firstName	string	Yes
lastName	string	Yes
birthDate	date	Yes		Accepted format: YYYY-MM-DD The beneficiary must be an adult - age > 18 years.
placeOfBirthCity	string	Yes
placeOfBirthCountry	string	Yes
cnp	string	Yes		CNP to be a valid romanian CNP CNP to match the birth date
idSeries	string	No
idNumber	string	No
citizenship	string	Yes
addressCountry	string	Yes
addressCity	string	Yes
addressStreet	string	Yes
addressNumber	string	Yes
addressDetails	string	No
controlTypeCode	string	Yes	The code for the control type the beneficiary holds into the company	To be a value of accepted control type codes. To get the list of accepted control type codes, use the nomenclature.

3. Sanctions Search

There are 3 types of possible sanction searches:

person
company (enterprise)
country

Endpoint: /sanctions/search

Parameter	Type	Required	Description	Validation Rules
type	string	Yes		To be one of the accepted types. In order to get the list of accepted types, use the nomenclature.
firstName	string	No		Required only if type=person
lastName	string	No		Required only if type=person
birthDate	string	No		Accepted format: YYYY-MM-DD
companyName	string	No		Required only if type=enterprise
countryName	string	No	Name or ISO2, ISO3 codes	Required only if type=country

4. Premium Alert

Endpoint: /premium/alert

Parameter	Type	Required	Validation Rules
offerId	integer	No	Numeric value, minimum 1
insuranceCategoryCode	string	Yes	Max. 5 characters
premiumAmount	decimal number	Yes	Numeric value, greater or equal to 0.
occasionalTransaction	boolean	Yes
multipleInstallments	boolean	Yes

5. Pep Profiles

Endpoint: /pep/profiles

Parameter	Type	Required	Description	Validation Rules
firstName	string	Yes
lastName	string	Yes
identification	string	Yes	Can be any of CNP or ID series / number
isPep	boolean	Yes		At least one of isPep or isRelativeToPep must be set to true.
isRelativeToPep	boolean	Yes

6. KYC Document

Endpoint: /kyc

Parameter	Type	Required	Validation Rules
firstName	string	Yes
lastName	string	Yes
dob.birthDate	date	Yes	Accepted format: YYYY-MM-DD The person must be an adult person → minimum age 18
dob.placeOfBirthCity	string	Yes
dob.placeOfBirthCountry	string	Yes
identification.cnp	string	Yes	Valid romanian CNP if citizenship is Romania/RO/ROU
identification.type	string	Yes	Value to be a valid IdentificationType - In order to get the list of accepted types, use the nomenclature.
identification.series	string	No
identification.number	string	Yes
identification.issueAuthority	string	Yes
identification.issueDate	date	Yes
identification.expiryDate	date	Yes
identification.citizenship	string	Yes
identification.residencyStatus	string	Yes	ResidencyStatus type. In order to get the list of accepted types, use the nomenclature.
homeAddress	AddressData	Yes
mailingAddress	AddressData	Yes	Optional - to be sent only if mailing address is different than home address.
contact.phone	string	Yes
contact.email	email	Yes	Valid email address
work.occupation	string	Yes
work.profession	string	Yes
work.employerName	string	Yes
work.activityNature	string	Yes
work.sourceOfFunds	string	Yes	SourceOfFundstype. In order to get the list of accepted types, use the nomenclature.
pep.holdsPublicOffice	string	No
pep.hasHoldPublicOffice	string	No
pep.familyMemberOfPep	string	No
pep.closeAssociateOfPep	string	No
realBeneficiaryOfPolicy.firstName	string	No	Required only Real Beneficiary is different than Policy Contractor
realBeneficiaryOfPolicy.lastName	string	No
realBeneficiaryOfPolicy.cnp	string	No
realBeneficiaryOfPolicy.relationWithContractor	string	No
fiscalResidency.countryOfFiscalResidency	array of string	Yes	Min 1 element
fiscalResidency.TINNumbers	array of string	Yes	Min 1 element
FATCA.usCitizen	boolean	Yes
FATCA.usFiscalResidency	boolean	Yes
intermediaryName	string	Yes
ASFCode	string	Yes

AddressData object details

Parameter	Type	Required
country	string	Yes
city	string	Yes
street	string	Yes
number	string	Yes
details	string	Yes

1. Introduction​

2. Beneficiary Declaration​

3. Sanctions Search​

4. Premium Alert​

5. Pep Profiles​

6. KYC Document​