Skip to main content
API docs by Redocly

aml.api.lifeishard.ro (0.1.0)

Download OpenAPI specification:Download

E-mail: api.support@lifeishard.ro

AML API Documentation

Nomenclature

Endpoints for retrieving nomenclature/lookup data

Get all sanction types

Returns a list of distinct sanction types available into the /sanctions/search endpoint.

header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get all control type codes

Returns a list of control type codes with their explanations, used to describe how control is exercised over a company or legal entity.

header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get identification types

Returns identification document types as (code, explanation).

header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get residency statuses

Returns residency statuses as (code, explanation).

header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get sources of funds

Returns sources of funds as (code, explanation).

header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Beneficiaries

Endpoints related to company real beneficiaries

Get simplified beneficiary summary list by CUI

Returns a simplified list of real beneficiaries for the given CUI. Depending on the calling account's configured source, the data is retrieved from local database tables or from the Listafirme.ro API.

Authorizations:
bearerAuth
path Parameters
cui
required
string
Example: 12345678

Company CUI (unique tax identifier)

header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Generate real beneficiaries declaration document

Generates a real beneficiaries declaration document (PDF, base64) for a given company and its beneficiaries. ControlTypeCode values are defined by the ControlTypeCode enum; the official list with explanations is available via GET /nomenclature/controlTypeCode.

Authorizations:
bearerAuth
header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Request Body schema: application/json
required
declarationDate
required
string <date>

Declaration date (YYYY-MM-DD)

companyName
required
string

Company legal name

companyRegNo
required
string

Company registration number

companyCui
required
string

Company CUI (unique tax identifier)

repFirstName
required
string

Legal representative first name

repLastName
required
string

Legal representative last name

repIdSeries
string or null

Representative identity document series (optional)

repIdNumber
string or null

Representative identity document number (optional)

repCnp
required
string

Representative personal numeric code / national ID

repSignature
string or null

Representative signature (optional). It is used in case the document will be electronically signed. If not provided, send null.

required
Array of objects (Beneficiary data) non-empty

List of real beneficiaries associated with the company

storeInDatabase
boolean

Whether to persist the company and beneficiaries in DB. Optional; defaults to true.

Responses

Request samples

Content type
application/json
{
  • "declarationDate": "2025-11-28",
  • "companyName": "Example SRL",
  • "companyRegNo": "J40/1234/2020",
  • "companyCui": "RO12345678",
  • "repFirstName": "Ion",
  • "repLastName": "Popescu",
  • "repIdSeries": "DX",
  • "repIdNumber": "123456",
  • "repCnp": "1234567890123",
  • "repSignature": null,
  • "beneficialOwners": [
    ],
  • "storeInDatabase": true
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get company and beneficiaries by CUI

Returns company data and its real beneficiaries for the given CUI.

Authorizations:
bearerAuth
path Parameters
cui
required
string
Example: RO12345678

Company CUI (unique tax identifier)

header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Sanctions

Endpoints for searching sanctions lists

Search sanctions list

Searches for persons, companies, countries, vessels, or aircraft against sanctions data (EU, UN, US OFAC, FATF). Includes fuzzy name matching and alias searching. For accounts configured with Refinitiv, person and enterprise searches are screened against LSEG World-Check One instead (source=REFINITIV); the other types always use local data. Sending birthDate for persons strongly reduces false positives. Use GET /nomenclature/sanctionType to get available types.

Authorizations:
bearerAuth
header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Request Body schema: application/json
required
type
required
string (SanctionsSearchTypeEnum)
Enum: "person" "enterprise" "vessel" "aircraft" "country" "other"

Type of entity to search in sanctions. Available types returned by GET /nomenclature/sanctionType.

firstName
string or null

Required when type=person. Person's first name.

lastName
string or null

Required when type=person. Person's last name.

birthDate
string or null <date>

Optional birth date filter (YYYY-MM-DD). Only used with type=person.

companyName
string or null

Required when type=enterprise. Company/organization name.

countryName
string or null

Required when type=country. Country name, ISO2 (e.g. 'BG'), or ISO3 code (e.g. 'BGR').

searchMatchAlgo
integer or null [ 0 .. 100 ]

Match strictness, 0–100. Higher = fewer false positives. Default 80. Only used for person/enterprise searches.

Responses

Request samples

Content type
application/json
{
  • "type": "person",
  • "firstName": "Maria",
  • "lastName": "PANKRATOVA",
  • "birthDate": "1980-05-10",
  • "companyName": "Star Sapphire",
  • "countryName": "BGR",
  • "searchMatchAlgo": 80
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Broker

Broker

Get broker action logs

Returns action logs for the broker identified by X-Broker-Name and X-Broker-Instance headers (via broker_headers middleware). Optionally filter by date range.

Authorizations:
bearerAuth
header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Request Body schema: application/json
optional
start_date
string or null <date>

Inclusive start date (YYYY-MM-DD).

end_date
string or null <date>

Inclusive end date (YYYY-MM-DD). Must be >= start_date if both are provided.

Responses

Request samples

Content type
application/json
{
  • "start_date": "2026-01-01",
  • "end_date": "2026-01-14"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

KYC

KYC

Generate KYC declaration document

Generates a KYC declaration document (PDF, base64) for a given KYC payload.

Authorizations:
bearerAuth
header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Request Body schema: application/json
required
firstName
required
string
lastName
required
string
required
object (Date of birth)
required
object (Identification)
required
object (Address)
(Address (object or null))

Optional, only if different than homeAddress

required
object (Contact)
required
object (Work information)
required
object (PEP information)
(Real beneficiary of policy (object or null))

Optional, only if beneficiary != contractor

required
Array of objects (Fiscal residency entry) non-empty
required
object (FATCA)
intermediaryName
required
string
ASFCode
required
string

Responses

Request samples

Content type
application/json
{
  • "firstName": "Marius",
  • "lastName": "Ion",
  • "dob": {
    },
  • "identification": {
    },
  • "homeAddress": {
    },
  • "mailingAddress": {
    },
  • "contact": {
    },
  • "work": {
    },
  • "pep": {
    },
  • "realBeneficiaryOfPolicy": {
    },
  • "fiscalResidency": [
    ],
  • "FATCA": {
    },
  • "intermediaryName": "Asigurator Georgel",
  • "ASFCode": "G123"
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Get KYC by CNP

Returns stored KYC data for a given CNP. Response format matches the POST /kyc request schema.

Authorizations:
bearerAuth
path Parameters
cnp
required
string
Example: 1740819314981

Unique identifier (CNP)

header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

PEP

PEP

Create PEP profile (idempotent)

Creates a PEP profile if it does not exist, otherwise returns the existing profile. Response is wrapped in a top-level 'data' object which contains { created, data }.

Authorizations:
bearerAuth
header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Request Body schema: application/json
required
firstName
required
string
lastName
required
string
identification
required
string

Unique identifier (e.g., CNP / internal identifier).

isPep
required
boolean

Exactly one of isPep or isRelativeToPep must be true.

isRelativeToPep
required
boolean

Exactly one of isPep or isRelativeToPep must be true.

Responses

Request samples

Content type
application/json
{
  • "firstName": "Ion",
  • "lastName": "Popescu",
  • "identification": "1234567890123",
  • "isPep": true,
  • "isRelativeToPep": false
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Screen a person for PEP status

Screens a natural person against LSEG World-Check One and returns whether they are a PEP or a relative / close associate of a PEP. Requires an account configured with Refinitiv. A sanctions search and a PEP search for the same person share one cached screening. Sending birthDate strongly reduces false positives.

Authorizations:
bearerAuth
header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Request Body schema: application/json
required
firstName
required
string
lastName
required
string
birthDate
string or null <date>

Optional birth date (YYYY-MM-DD). Strongly recommended: without it only the name is matched and common names produce false positives.

searchMatchAlgo
integer or null [ 0 .. 100 ]

Minimum World-Check match score, 0–100. Default 80.

Responses

Request samples

Content type
application/json
{
  • "firstName": "Catalina",
  • "lastName": "Ivan",
  • "birthDate": "1980-05-10",
  • "searchMatchAlgo": 80
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Premium

Premium

Evaluate premium alert

Evaluates a premium amount against configured thresholds and returns whether an alert is triggered. The ruleApplied field uses the PremiumAlertRule enum.

Authorizations:
bearerAuth
header Parameters
Token
required
string

Login Token

X-Broker-Name
required
string
Example: MyBroker

Broker name identifier (required)

X-Broker-Instance
required
string
Example: production

Broker instance identifier (required)

Request Body schema: application/json
required
offerId
integer or null <int32>

Optional offer identifier (if available).

insuranceCategoryCode
required
string

Insurance category code used to apply category-specific rules.

premiumAmount
required
number <float>

Premium amount used to evaluate the alert.

occasionalTransaction
required
boolean

True if the premium is for an occasional transaction.

multipleInstallments
required
boolean

True if the premium is paid in multiple installments.

Responses

Request samples

Content type
application/json
{
  • "offerId": 12345,
  • "insuranceCategoryCode": "C1",
  • "premiumAmount": 25000.5,
  • "occasionalTransaction": false,
  • "multipleInstallments": true
}

Response samples

Content type
application/json
{
  • "data": {
    }
}

Authentication

Authentication

Authenticate

Authenticate an account by account/password

query Parameters
account
required
string

Account

password
required
string

Password

Responses

Response samples

Content type
application/json
{
  • "error": "false",
  • "status": "200",
  • "data": {
    }
}

Deautenticate

Deautenticate an existing and valid auth token

Responses

Renew token

Renew an authentication token

header Parameters
Token
required
string
Example: Refresh [refresh_token]

The Refresh token received from the POST /auth or PATCH /auth endpoint's response field name refresh_token.

Responses

Response samples

Content type
application/json
{
  • "error": "false",
  • "status": "200",
  • "data": {
    }
}