Errors

{"resultType": "REQUEST_ACCEPTED"}

{
  "resultType": "REQUEST_REJECTED",
  "errorCode": "C008.I01",
  "errorDescription": "When source of risk level IMPORT.  RiskLevel is mandatory, values: NONE, LOW, MEDIUM, HIGH, EXTREME"
}

{
  "timestamp": "2025-12-16T13:50:34.272+00:00",
  "status": 400,
  "error": "Bad Request",
  "path": "/amlyze-ws-rest/customer"
}

{
  "errors": [
    "Field: 'communicationNumber', message: 'CommunicationNumber is mandatory'"
  ]
}

{
  "error": {
    "code": "unauthorized"
  }
}

{
  "timestamp": "2025-12-16T13:51:12.162+00:00",
  "status": 404,
  "error": "Not Found",
  "path": "/amlyze-ws-rest/not-found"
}

{
  "resultType": "REQUEST_REJECTED",
  "errorCode": "500",
  "errorDescription": "failed processing customer"
}

Response structure

string

Error code.

string

Error description.

string

Result type.

array

List of error descriptions.

string

Timestamp when the error occurred.

number

HTTP status code.

string

Error description.

string

Api path in which error occurred.

{"resultType": "REQUEST_ACCEPTED"}

{
  "resultType": "REQUEST_REJECTED",
  "errorCode": "C008.I01",
  "errorDescription": "When source of risk level IMPORT.  RiskLevel is mandatory, values: NONE, LOW, MEDIUM, HIGH, EXTREME"
}

{
  "timestamp": "2025-12-16T13:50:34.272+00:00",
  "status": 400,
  "error": "Bad Request",
  "path": "/amlyze-ws-rest/customer"
}

{
  "errors": [
    "Field: 'communicationNumber', message: 'CommunicationNumber is mandatory'"
  ]
}

{
  "error": {
    "code": "unauthorized"
  }
}

{
  "timestamp": "2025-12-16T13:51:12.162+00:00",
  "status": 404,
  "error": "Not Found",
  "path": "/amlyze-ws-rest/not-found"
}

{
  "resultType": "REQUEST_REJECTED",
  "errorCode": "500",
  "errorDescription": "failed processing customer"
}

{"resultType": "REQUEST_ACCEPTED"}

{
  "resultType": "REQUEST_REJECTED",
  "errorCode": "C008.I01",
  "errorDescription": "When source of risk level IMPORT.  RiskLevel is mandatory, values: NONE, LOW, MEDIUM, HIGH, EXTREME"
}

{
  "timestamp": "2025-12-16T13:50:34.272+00:00",
  "status": 400,
  "error": "Bad Request",
  "path": "/amlyze-ws-rest/customer"
}

{
  "errors": [
    "Field: 'communicationNumber', message: 'CommunicationNumber is mandatory'"
  ]
}

{
  "error": {
    "code": "unauthorized"
  }
}

{
  "timestamp": "2025-12-16T13:51:12.162+00:00",
  "status": 404,
  "error": "Not Found",
  "path": "/amlyze-ws-rest/not-found"
}

{
  "resultType": "REQUEST_REJECTED",
  "errorCode": "500",
  "errorDescription": "failed processing customer"
}

Response structure

string

Error code.

string

Error description.

string

Result type.

array

List of error descriptions.

string

Timestamp when the error occurred.

number

HTTP status code.

string

Error description.

string

Api path in which error occurred.

AMLYZE uses conventional HTTP response codes to indicate the success or failure of an API request. In general:

Codes in the 2xx range indicate success.
Codes in the 4xx range indicate a business error that failed given the information provided (e.g., a required parameter was omitted, provided value is incorrect, etc.).
Codes in the 5xx range indicate an internal error within AMLYZE servers (these are rare).

4xx errors include an error code and description that briefly explains the error reported.

List of Errors

Some error codes contain [[dynamicValue]] - this value in the description is replaced by actual value based on the context. It could be value from classifier or from the enum or some other aspect that is dynamic and might change.

Never rely on the error description as a case for handling. Always use error code for that. Descriptions change frequently to reflect new contextual information available in the api or to provide better understanding of the problem space.

Error Code	Description
	AccountExtId is mandatory
	AccountNumber is mandatory
	ActivityInRestrictedRegionDescription
	BirthCountry
	BirthDate
	BusinessEntityExtId is mandatory
	CitizenshipCountry
	CompanyAssetValue
	EstablishmentDate
	FirstName
	GIIN
	Given customer exists as regular customer
	LastName
	LegalForm
	LEI
	LicenseDescription
	NumberOfAudits
	NumberOfEmployees
	OrganizationalStructureDescription
	PeriodsOfAuditsInYears
	PermanentResidenceCountry
	RegionOfActivityDescription
	SecondCitizenshipCountry
	ThirdPartyServicesUsedDescription
	Title
	TradingName
001	CommunicationNumber is mandatory
001	Currency does not exist in Amlyze
001	Requester is mandatory
002	CLOSED account requires closingDate
002	Invalid Account status, allowed values: ACTIVE, SUSPENDED, CLOSED;
002	not closed account cant have closing date
003	Account already linked with other customer
005	Given bic does not belong to your institution
005	when using external account, bic is mandatory
006	Given AccountType does not exist in Amlyze
007	openingDate is mandatory
400	Cannot register account for lead customer
404	BusinessEntity with given extId does not exist in amlyze
500	failed processing account balance
500	failed Processing account
500	failed processing contract
500	failed processing customer
500	failed Processing operation
500	failed processing simplified customer
A001	The additional property code is mandatory.
A001	The additional property title is mandatory.
A001	The boolean value of ‘[[dynamicValue]]’ is invalid ‘[[dynamicValue]]’ true/false.
A001	The value of ‘[[dynamicValue]]’ is in an invalid format ‘yyyy-MM-dd’ ‘[[dynamicValue]]’.
A001	The value of ‘[[dynamicValue]]’ is in an invalid format ‘yyyy-MM-dd’T’HH:mm:ss.SSS’Z” ‘[[dynamicValue]]’.
A001	The value of ‘[[dynamicValue]]’ is out of bounds or in an invalid format ‘[[dynamicValue]]’.
A01	AmountInEquivalent or deprecated AmountInEuro is mandatory and must be greater than 0.
A01	AmountInEquivalent is mandatory and must be greater than 0.
A02	EuroExchangeRate deprecated must be greater than 0.
A02	ExchangeRate must be greater than 0.
AC01	ActivityType is mandatory
AC02	ActivityType must be defined in Amlyze
ADR01	AddressType is mandatory.
ADR02	AddressType is not defined in amlyze.
ADR02	Country is mandatory and cant be empty
ADR02	Country is mandatory and must exist in Amlyze
AR01	AppealReasonType is mandatory and must defined in Amlyze
AR02	AppealReasonType is mandatory and cant be empty
AV01	AdditionalValue.Code is mandatory
AV02	AdditionalValue.Description is mandatory
AV03	AdditionalValue.Value is mandatory
AV04	AdditionalValue.Datatype is mandatory
AV05	Dublicate code in additionalValues, [[dynamicValue]]
AV06	Bad datatype valueCode: [[dynamicValue]]
AV07	bad value for [[dynamicValue]] valueCode: [[dynamicValue]]
AV07	bad value for [[dynamicValue]] format: ‘yyyy-MM-dd HH:mm:ss.SSSZ’ valueCode: [[dynamicValue]]
AV07	bad value for [[dynamicValue]] format: ‘yyyy-MM-dd HH:mm:ss.SSSZ’ valueCode: [[dynamicValue]]
AV07	bad value for [[dynamicValue]] format: ‘yyyy-MM-dd’ valueCode: [[dynamicValue]]
AV07	bad value for [[dynamicValue]] format: ‘yyyy-MM-dd’ valueCode: [[dynamicValue]]
AV07	bad value for [[dynamicValue]] values: true false’ valueCode: [[dynamicValue]]
AV07	bad value for [[dynamicValue]] valueCode: [[dynamicValue]]
C001	The account balance external ID is mandatory.
C001	The account balance type is mandatory.
C001	The contract external ID is mandatory.
C001	The contract type is mandatory.
C001	The customer external ID is mandatory.
C001	The requester is mandatory.
C002	A account balance type ‘[[dynamicValue]]’ was not found in the system.
C002	A contract type ‘[[dynamicValue]]’ was not found in the system.
C002	A contract with the external ID ‘[[dynamicValue]]’ already exists. The contract can only be updated.
C002	A contract with the external ID ‘[[dynamicValue]]’ does not exist. The contract can only be created.
C002	A customer with the external ID ‘[[dynamicValue]]’ was not found.
C002	additionalProperties[[[dynamicValue]]].
C002	An account with the external ID ‘[[dynamicValue]]’ was not found.
C002	CustomerExtId is mandatory.
C004	Cannot update not existing customer, use Action = CREATE
C004	Customer already exists
C005	DELETE not yet implemented, contact Amlyze support
C006	Requester is mandatory.
C007	RiskManagementCategory does not exist in Amlyze
C007	RiskManagementCategory is mandatory.
C008.E01	When source of risk level EVALUATE. RiskLevel can’t be provided
C008.I01	When source of risk level IMPORT. RiskLevel is mandatory, values: NONE, LOW, MEDIUM, HIGH, EXTREME
C008.I02	When source of risk level IMPORT. ‘Lead’ risk management category is forbidden
C008	SourceOfRiskLevel is mandatory. Values: IMPORT, EVALUATE
C009	When importing, CustomerStatus is mandatory.
C010	EntityType is mandatory.
C012	ApplicationDate is mandatory
C013	ClosingDate is mandatory for CLOSED CustomerStatus
C013a	ClosingDate can not exist for not CLOSED CustomerStatus
C014	EntityType is mandatory
C014	Field not allowed for INDIVIDUAL. Field:
C015	Field not allowed for ORGANIZATION. Field:
C016.I06	BirthCountry not defined in Amlyze
C016.I06	Problem with field for INDIVIDUAL type customer. CitizenshipCountry not found in amlyze
C016.I07	CitizenshipCountry not defined in Amlyze
C016.I08	permanentResidenceCountry not defined in Amlyze
C016.I08	SecondCitizenshipCountry not defined in Amlyze
C016	For INDIVIDUAL type customer
C016	Problem with field for INDIVIDUAL type customer.
C016	Problem with relatedEntities.
C016	Problem with relatedEntity (index: [[dynamicValue]]).
C017	For ORGANIZATION type customer
C017	Problem with field for ORGANIZATION type customer.
CA01	CountryOfActivity must be defined
CA01	CountryOfActivity not found in Amlyze
CARD_REFUND_op	for card_refund subtype, creditor must be your customer
Co1	ContactType is mandatory. values: MOBILEPHONE, FIXEDPHONE, EMAIL, WEBSITE
Co2	ContactDetails is mandatory
COTP01	CountryOfTaxPayment cant be empty
COTP01	CountryOfTaxPayment not found in Amlyze
DOC01	EntityType is mandatory. values : INDIVIDUAL, ORGANIZATION
DOC02	IdentityDocumentType is mandatory. values: PASSPORT IDENTITYCARD, RESIDENCEPERMIT, DRIVINGLICENSE, REGISTRATIONCERTIFICATE, OTHER
DOC03	DocumentNumber is mandatory.
DOC04	DocumentIssueDate is mandatory.
DOC06	DocumentIssueCountry is mandatory and must exist in Amlyze
DOC07	DocumentIssueAuthority is mandatory
DT01	TurnoverType is mandatory
DT01	TurnoverType must exist in amlyze
DT02	At least one value must be specified (FROM, TO
DT03	TurnoverRange is mandatory. Values: SINGLE, DAILY, MONTHLY, ANNUAL
FOA01	FieldOfActivity.Student.Country is invalid
FOA02	PensionCountry is invalid
I01	FirstName is mandatory
I02	LastName is mandatory
IS01	IncomeSourceType is mandatory and exist in Amlyze
IS01	IntroductionSource not found in amlyze
IS02	IntroductionSource not found in amlyze
LEAD	Cannot demote existing customer to Lead riskManagementCategory
legalForm	LegalForm must exist in Amlyze
MCC01	Invalid MerchantCountryCode
O001	CommunicationNumber already used in amlyze
O001	CommunicationNumber is mandatory
O001	CommunicationNumber was already used in Amlyze
O0018	OperationDateTime is mandatory.
O002	OperationExtId is mandatory
O002	Requester is mandatory
O003	Action is not supported.
O004	SourceOfRiskLevel is mandatory, allowed values: IMPORT / EVALUATE.
O005	Operation with given OperationExtId already exists in Amlyze
O005	Operation with given OperationExtId does not exist in Amlyze
O006	OperationType is mandatory
O006	Problem with OperationType [[dynamicValue]]. CardOperationSubType is mandatory
O006	Problem with OperationType [[dynamicValue]]. CardOperationSubType[[dynamicValue]] requires [[dynamicValue]]direction
O006	Problem with OperationType [[dynamicValue]]. Subtype not found in Amlyze
O006	Problem with OperationType [[dynamicValue]].
O007	ListOperationParty is mandatory and can’t be empty.
O007	Problem with operation party (index: [[dynamicValue]]).
O008	Problem with SourceOfRiskLevel [[dynamicValue]].
O008	SourceOfRiskLevel is mandatory.
O009	OperationDateTime is mandatory.
O01	Title is mandatory
O010	SourceCountry is mandatory, check country classifier codes for allowed values.
O010	SourceCountry is mandatory, check country classifier codes for allowed values.
O011	DestinationCountry is mandatory, check country classifier codes for allowed values.
O011	DestinationCountry is mandatory, check country classifier codes for allowed values.
O012	Currency is mandatory, check Currency classifier codes for allowed values.
O013	Amount is mandatory and must be > 0.
O013	Amount is mandatory and must be greater than 0.
O013	When currency != [[dynamicValue]].
O013e	Despite currency = [[dynamicValue]], AmountInEquivalent differs from Amount
O013e	Despite currency = [[dynamicValue]], AmountInEuro differs from Amount
O015	For not INTERNAL operation financialFlowDirection value cant be ‘NULL’
O015a	Invalid FinancialFlowDirection. Your institution DEBTOR found for INCOMING operation
O015b	Invalid FinancialFlowDirection. Your institution CREDITOR found for OUTGOING operation
O016	RiskManagementCategory does not exist in Amlyze
O016	RiskManagementCategory is mandatory
O019	OperationParties must contain CREDITOR
O02	RegistrationCountry is mandatory
O020	OperationParties must contain DEBTOR
O021	Description is mandatory
O021	For cryptoExchange at least one currency must be crypto
O021	For cryptoExchange operationPartyCurrencies must differ
O021	PIS operation financialFlowDirection can’t be OUTGOING
O03	LegalForm is mandatory
OP_roles	for INCOMING operation your’s customer party role must be CREDITOR
OP_roles	for OUTGOING operation your’s customer party role must be DEBTOR
Op00	AccountNumber or CardNumber is mandatory. for card operation
OP00	operation party title or firstName or lastName or cardHolderName is mandatory
OP01	AccountNumber is mandatory.
Op01	Invalid operation party count. Range: min 1 max 4.
OP02	BIC is mandatory.
Op02	Invalid count of operation parties for [[dynamicValue]] operationType
Op02	Invalid count of your institution operation parties for [[dynamicValue]] operationType
Op03	Invalid count of your institution operation parties for [[dynamicValue]] operationType
Op04	Currency is mandatory, check Currency classifier codes for allowed values
OP04	EntityType is mandatory, values: INDIVIDUAL, ORGANIZATION, UNKNOWN
Op04	No operation party account related to your institution BIC, or Customer
OP05	PartyRole is mandatory, possible values: CREDITOR, ULTIMATE_CREDITOR
OP05	PartyRole is mandatory, possible values: DEBTOR, CREDITOR, ULTIMATE_DEBTOR, ULTIMATE_CREDITOR
OP06	Account registered to your institution, Account found in amlyze, but customer not found in Amlyze
OP06	Account registered to your institution, Account found in Amlyze, but customer not found in Amlyze
OP06	The value for the country in the party is not within the allowed values specified by the country classifier.
Op19	CREDITOR bic is mandatory.
OPi01	For INDIVIDUAL party firstName + lastName, title is mandatory.
OPi01	For INDIVIDUAL party firstName + lastName, title or identifier is mandatory.
OPi01	For UNKNOWN party title is mandatory.
OPi01	For UNKNOWN party title or identifier is mandatory.
OPo01	For ORGANIZATION party firstName or lastName cannot be provided.
OPo01	For ORGANIZATION party title is mandatory.
OPo01	For ORGANIZATION party title or identifier is mandatory.
OPo01	For UNKNOWN party firstName or lastName cannot be provided.
OST01	ServiceType not found in Amlyze
OST02	ServiceType not found in Amlyze
Ot01	[[dynamicValue]] is not defined in Amlyze. Check Operation type classifier for available values.
Ot02	Problem with OperationParties.
PP01	PaymentPurposeType does not exist in Amlyze
PP02	TurnoverDirection is invalid
Q001	InitialDepositCurrency not found in amlyze
Q002	Problem with Customer BusinessEntityDocument index = [[dynamicValue]].
Q003	Problem with Customer Contact index = [[dynamicValue]].
Q004	Problem with Address (index: [[dynamicValue]]). classifier [[dynamicValue]]
Q004	Problem with Address (index: [[dynamicValue]]).
Q006	Problem with IncomeSource (index: [[dynamicValue]]).
Q007	Problem with activity (index: [[dynamicValue]]).
Q008	Problem with RegionOfActivity (index: [[dynamicValue]]).
Q009	Problem with CountryOfActivity (index: [[dynamicValue]]).
Q010	Problem with ListAppealReason (index: [[dynamicValue]]).
Q011	Problem with IntroductionSource (index: [[dynamicValue]]).
Q012	Problem with OrderedService (index: [[dynamicValue]]).
Q013	Problem with DeclaredTurnover (index: [[dynamicValue]]).
Q014	Problem with PaymentCountry (index: [[dynamicValue]]).
Q015	Problem with PaymentPurpose (index: [[dynamicValue]]).
Q017	CountryOfTaxPayment (index: [[dynamicValue]]).
RA01	RegionOfActivity must be defined
RA01	RegionOfActivity not found in Amlyze
RC01	PaymentCountry not found in Amlyze
RC02	PaymentCountry cant be empty
RC02	TurnoverDirection is invalid
RE00	first and last name or title is mandatory for Individual
RE00	Title is mandatory for ORGANIZATION
RE00	Title or firstName + lastName is mandatory
RE01	Relation type is mandatory
RE01	Relation type is not defined in Amlyze
RE02	EntityType is mandatory.
RE03	BirthCountry not defined in Amlyze
RE03	Country not defined in Amlyze
RE05	LegalForm not found in Amlyze
RE06	Problem with Address (index: [[dynamicValue]]).
RE06	Problem with Contact (index: [[dynamicValue]]).
RE08	Problem with BusinessEntityDocuments (index: [[dynamicValue]]).
RE09	Problem with IncomeSource (index: [[dynamicValue]]).
RE10	Problem with activity (index: [[dynamicValue]]).
RE11	Problem with RegionOfActivity (index: [[dynamicValue]]).
RE12	Problem with CountryOfActivity (index: [[dynamicValue]]).
RE13	Related entity list got duplicates (index: [[dynamicValue]]) and [[dynamicValue]].
REG	registrationCountry is invalid
REG	registrationCountry must exist in Amlyze
SCR01	screening process is undefined: [[dynamicValue]]
SEC1	Business unit is mandatory
SEC1	Tenant header ‘[[dynamicValue]]’ is mandatory
SEC3	Tenant ‘[[dynamicValue]]’ business unit ‘[[dynamicValue]]’ does not exist
SoRL01	OperationStatus is mandatory for IMPORT operation. Possible values: REJECTED / EXECUTED.
SoRL02	OperationStatus must be empty for EVALUATE operation
SOV01	SourceOfWealth [[dynamicValue]] is not defined in amlyze

Access & Security Communication Number

API Reference

Endpoints

Webhooks

Response structure

Response structure

List of Errors

Response structure

Response structure

​List of Errors

List of Errors