Skip to main content
{"resultType": "REQUEST_ACCEPTED"}

Response structure

errorCode
string
Error code.
errorDescription
string
Error description.
resultType
string
Result type.
errors
array
List of error descriptions.
timestamp
string
List of error descriptions.
status
number
HTTP status code.
error
string
Error description.
path
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 an 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 includes an error code and description that briefly explains the error reported.

List of errors

Some error codes contains [[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 CodeDescription
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
001CommunicationNumber is mandatory
001Currency does not exist in Amlyze
001Requester is mandatory
002CLOSED account requires closingDate
002Invalid Account status, allowed values: ACTIVE, SUSPENDED, CLOSED;
002not closed account cant have closing date
003Account already linked with other customer
005Given bic does not belong to your institution
005when using external account, bic is mandatory
006Given AccountType does not exist in Amlyze
007openingDate is mandatory
400Cannot register account for lead customer
404BusinessEntity with given extId does not exist in amlyze
500failed processing account balance
500failed Processing account
500failed processing contract
500failed processing customer
500failed Processing operation
500failed processing simplified customer
A001The additional property code is mandatory.
A001The additional property title is mandatory.
A001The boolean value of ‘[[dynamicValue]]’ is invalid ‘[[dynamicValue]]’ true/false.
A001The value of ‘[[dynamicValue]]’ is in an invalid format ‘yyyy-MM-dd’ ‘[[dynamicValue]]’.
A001The value of ‘[[dynamicValue]]’ is in an invalid format ‘yyyy-MM-dd’T’HH:mm:ss.SSS’Z” ‘[[dynamicValue]]’.
A001The value of ‘[[dynamicValue]]’ is out of bounds or in an invalid format ‘[[dynamicValue]]’.
A01AmountInEquivalent or deprecated AmountInEuro is mandatory and must be greater than 0.
A01AmountInEquivalent is mandatory and must be greater than 0.
A02EuroExchangeRate deprecated must be greater than 0.
A02ExchangeRate must be greater than 0.
AC01ActivityType is mandatory
AC02ActivityType must be defined in Amlyze
ADR01AddressType is mandatory.
ADR02AddressType is not defined in amlyze.
ADR02Country is mandatory and cant be empty
ADR02Country is mandatory and must exist in Amlyze
AR01AppealReasonType is mandatory and must defined in Amlyze
AR02AppealReasonType is mandatory and cant be empty
AV01AdditionalValue.Code is mandatory
AV02AdditionalValue.Description is mandatory
AV03AdditionalValue.Value is mandatory
AV04AdditionalValue.Datatype is mandatory
AV05Dublicate code in additionalValues, [[dynamicValue]]
AV06Bad datatype valueCode: [[dynamicValue]]
AV07bad value for [[dynamicValue]] valueCode: [[dynamicValue]]
AV07bad value for [[dynamicValue]] format: ‘yyyy-MM-dd HH:mm:ss.SSSZ’ valueCode: [[dynamicValue]]
AV07bad value for [[dynamicValue]] format: ‘yyyy-MM-dd HH:mm:ss.SSSZ’ valueCode: [[dynamicValue]]
AV07bad value for [[dynamicValue]] format: ‘yyyy-MM-dd’ valueCode: [[dynamicValue]]
AV07bad value for [[dynamicValue]] format: ‘yyyy-MM-dd’ valueCode: [[dynamicValue]]
AV07bad value for [[dynamicValue]] values: true false’ valueCode: [[dynamicValue]]
AV07bad value for [[dynamicValue]] valueCode: [[dynamicValue]]
C001The account balance external ID is mandatory.
C001The account balance type is mandatory.
C001The contract external ID is mandatory.
C001The contract type is mandatory.
C001The customer external ID is mandatory.
C001The requester is mandatory.
C002A account balance type ‘[[dynamicValue]]’ was not found in the system.
C002A contract type ‘[[dynamicValue]]’ was not found in the system.
C002A contract with the external ID ‘[[dynamicValue]]’ already exists. The contract can only be updated.
C002A contract with the external ID ‘[[dynamicValue]]’ does not exist. The contract can only be created.
C002A customer with the external ID ‘[[dynamicValue]]’ was not found.
C002additionalProperties[[[dynamicValue]]].
C002An account with the external ID ‘[[dynamicValue]]’ was not found.
C002CustomerExtId is mandatory.
C004Cannot update not existing customer, use Action = CREATE
C004Customer already exists
C005DELETE not yet implemented, contact Amlyze support
C006Requester is mandatory.
C007RiskManagementCategory does not exist in Amlyze
C007RiskManagementCategory is mandatory.
C008.E01When source of risk level EVALUATE. RiskLevel can’t be provided
C008.I01When source of risk level IMPORT. RiskLevel is mandatory, values: NONE, LOW, MEDIUM, HIGH, EXTREME
C008.I02When source of risk level IMPORT. ‘Lead’ risk management category is forbidden
C008SourceOfRiskLevel is mandatory. Values: IMPORT, EVALUATE
C009When importing, CustomerStatus is mandatory.
C010EntityType is mandatory.
C012ApplicationDate is mandatory
C013ClosingDate is mandatory for CLOSED CustomerStatus
C013aClosingDate can not exist for not CLOSED CustomerStatus
C014EntityType is mandatory
C014Field not allowed for INDIVIDUAL. Field:
C015Field not allowed for ORGANIZATION. Field:
C016.I06BirthCountry not defined in Amlyze
C016.I06Problem with field for INDIVIDUAL type customer. CitizenshipCountry not found in amlyze
C016.I07CitizenshipCountry not defined in Amlyze
C016.I08permanentResidenceCountry not defined in Amlyze
C016.I08SecondCitizenshipCountry not defined in Amlyze
C016For INDIVIDUAL type customer
C016Problem with field for INDIVIDUAL type customer.
C016Problem with relatedEntities.
C016Problem with relatedEntity (index: [[dynamicValue]]).
C017For ORGANIZATION type customer
C017Problem with field for ORGANIZATION type customer.
CA01CountryOfActivity must be defined
CA01CountryOfActivity not found in Amlyze
CARD_REFUND_opfor card_refund subtype, creditor must be your customer
Co1ContactType is mandatory. values: MOBILEPHONE, FIXEDPHONE, EMAIL, WEBSITE
Co2ContactDetails is mandatory
COTP01CountryOfTaxPayment cant be empty
COTP01CountryOfTaxPayment not found in Amlyze
DOC01EntityType is mandatory. values : INDIVIDUAL, ORGANIZATION
DOC02IdentityDocumentType is mandatory. values: PASSPORT IDENTITYCARD, RESIDENCEPERMIT, DRIVINGLICENSE, REGISTRATIONCERTIFICATE, OTHER
DOC03DocumentNumber is mandatory.
DOC04DocumentIssueDate is mandatory.
DOC06DocumentIssueCountry is mandatory and must exist in Amlyze
DOC07DocumentIssueAuthority is mandatory
DT01TurnoverType is mandatory
DT01TurnoverType must exist in amlyze
DT02At least one value must be specified (FROM, TO
DT03TurnoverRange is mandatory. Values: SINGLE, DAILY, MONTHLY, ANNUAL
FOA01FieldOfActivity.Student.Country is invalid
FOA02PensionCountry is invalid
I01FirstName is mandatory
I02LastName is mandatory
IS01IncomeSourceType is mandatory and exist in Amlyze
IS01IntroductionSource not found in amlyze
IS02IntroductionSource not found in amlyze
LEADCannot demote existing customer to Lead riskManagementCategory
legalFormLegalForm must exist in Amlyze
MCC01Invalid MerchantCountryCode
O001CommunicationNumber already used in amlyze
O001CommunicationNumber is mandatory
O001CommunicationNumber was already used in Amlyze
O0018OperationDateTime is mandatory.
O002OperationExtId is mandatory
O002Requester is mandatory
O003Action is not supported.
O004SourceOfRiskLevel is mandatory, allowed values: IMPORT / EVALUATE.
O005Operation with given OperationExtId already exists in Amlyze
O005Operation with given OperationExtId does not exist in Amlyze
O006OperationType is mandatory
O006Problem with OperationType [[dynamicValue]]. CardOperationSubType is mandatory
O006Problem with OperationType [[dynamicValue]]. CardOperationSubType[[dynamicValue]] requires [[dynamicValue]]direction
O006Problem with OperationType [[dynamicValue]]. Subtype not found in Amlyze
O006Problem with OperationType [[dynamicValue]].
O007ListOperationParty is mandatory and can’t be empty.
O007Problem with operation party (index: [[dynamicValue]]).
O008Problem with SourceOfRiskLevel [[dynamicValue]].
O008SourceOfRiskLevel is mandatory.
O009OperationDateTime is mandatory.
O01Title is mandatory
O010SourceCountry is mandatory, check country classifier codes for allowed values.
O010SourceCountry is mandatory, check country classifier codes for allowed values.
O011DestinationCountry is mandatory, check country classifier codes for allowed values.
O011DestinationCountry is mandatory, check country classifier codes for allowed values.
O012Currency is mandatory, check Currency classifier codes for allowed values.
O013Amount is mandatory and must be > 0.
O013Amount is mandatory and must be greater than 0.
O013When currency != [[dynamicValue]].
O013eDespite currency = [[dynamicValue]], AmountInEquivalent differs from Amount
O013eDespite currency = [[dynamicValue]], AmountInEuro differs from Amount
O015For not INTERNAL operation financialFlowDirection value cant be ‘NULL’
O015aInvalid FinancialFlowDirection. Your institution DEBTOR found for INCOMING operation
O015bInvalid FinancialFlowDirection. Your institution CREDITOR found for OUTGOING operation
O016RiskManagementCategory does not exist in Amlyze
O016RiskManagementCategory is mandatory
O019OperationParties must contain CREDITOR
O02RegistrationCountry is mandatory
O020OperationParties must contain DEBTOR
O021Description is mandatory
O021For cryptoExchange at least one currency must be crypto
O021For cryptoExchange operationPartyCurrencies must differ
O021PIS operation financialFlowDirection can’t be OUTGOING
O03LegalForm is mandatory
OP_rolesfor INCOMING operation your’s customer party role must be CREDITOR
OP_rolesfor OUTGOING operation your’s customer party role must be DEBTOR
Op00AccountNumber or CardNumber is mandatory. for card operation
OP00operation party title or firstName or lastName or cardHolderName is mandatory
OP01AccountNumber is mandatory.
Op01Invalid operation party count. Range: min 1 max 4.
OP02BIC is mandatory.
Op02Invalid count of operation parties for [[dynamicValue]] operationType
Op02Invalid count of your institution operation parties for [[dynamicValue]] operationType
Op03Invalid count of your institution operation parties for [[dynamicValue]] operationType
Op04Currency is mandatory, check Currency classifier codes for allowed values
OP04EntityType is mandatory, values: INDIVIDUAL, ORGANIZATION, UNKNOWN
Op04No operation party account related to your institution BIC, or Customer
OP05PartyRole is mandatory, possible values: CREDITOR, ULTIMATE_CREDITOR
OP05PartyRole is mandatory, possible values: DEBTOR, CREDITOR, ULTIMATE_DEBTOR, ULTIMATE_CREDITOR
OP06Account registered to your institution, Account found in amlyze, but customer not found in Amlyze
OP06Account registered to your institution, Account found in Amlyze, but customer not found in Amlyze
OP06The value for the country in the party is not within the allowed values specified by the country classifier.
Op19CREDITOR bic is mandatory.
OPi01For INDIVIDUAL party firstName + lastName, title is mandatory.
OPi01For INDIVIDUAL party firstName + lastName, title or identifier is mandatory.
OPi01For UNKNOWN party title is mandatory.
OPi01For UNKNOWN party title or identifier is mandatory.
OPo01For ORGANIZATION party firstName or lastName cannot be provided.
OPo01For ORGANIZATION party title is mandatory.
OPo01For ORGANIZATION party title or identifier is mandatory.
OPo01For UNKNOWN party firstName or lastName cannot be provided.
OST01ServiceType not found in Amlyze
OST02ServiceType not found in Amlyze
Ot01[[dynamicValue]] is not defined in Amlyze. Check Operation type classifier for available values.
Ot02Problem with OperationParties.
PP01PaymentPurposeType does not exist in Amlyze
PP02TurnoverDirection is invalid
Q001InitialDepositCurrency not found in amlyze
Q002Problem with Customer BusinessEntityDocument index = [[dynamicValue]].
Q003Problem with Customer Contact index = [[dynamicValue]].
Q004Problem with Address (index: [[dynamicValue]]). classifier [[dynamicValue]]
Q004Problem with Address (index: [[dynamicValue]]).
Q006Problem with IncomeSource (index: [[dynamicValue]]).
Q007Problem with activity (index: [[dynamicValue]]).
Q008Problem with RegionOfActivity (index: [[dynamicValue]]).
Q009Problem with CountryOfActivity (index: [[dynamicValue]]).
Q010Problem with ListAppealReason (index: [[dynamicValue]]).
Q011Problem with IntroductionSource (index: [[dynamicValue]]).
Q012Problem with OrderedService (index: [[dynamicValue]]).
Q013Problem with DeclaredTurnover (index: [[dynamicValue]]).
Q014Problem with PaymentCountry (index: [[dynamicValue]]).
Q015Problem with PaymentPurpose (index: [[dynamicValue]]).
Q017CountryOfTaxPayment (index: [[dynamicValue]]).
RA01RegionOfActivity must be defined
RA01RegionOfActivity not found in Amlyze
RC01PaymentCountry not found in Amlyze
RC02PaymentCountry cant be empty
RC02TurnoverDirection is invalid
RE00first and last name or title is mandatory for Individual
RE00Title is mandatory for ORGANIZATION
RE00Title or firstName + lastName is mandatory
RE01Relation type is mandatory
RE01Relation type is not defined in Amlyze
RE02EntityType is mandatory.
RE03BirthCountry not defined in Amlyze
RE03Country not defined in Amlyze
RE05LegalForm not found in Amlyze
RE06Problem with Address (index: [[dynamicValue]]).
RE06Problem with Contact (index: [[dynamicValue]]).
RE08Problem with BusinessEntityDocuments (index: [[dynamicValue]]).
RE09Problem with IncomeSource (index: [[dynamicValue]]).
RE10Problem with activity (index: [[dynamicValue]]).
RE11Problem with RegionOfActivity (index: [[dynamicValue]]).
RE12Problem with CountryOfActivity (index: [[dynamicValue]]).
RE13Related entity list got duplicates (index: [[dynamicValue]]) and [[dynamicValue]].
REGregistrationCountry is invalid
REGregistrationCountry must exist in Amlyze
SCR01screening process is undefined: [[dynamicValue]]
SEC1Business unit is mandatory
SEC1Tenant header ‘[[dynamicValue]]’ is mandatory
SEC3Tenant ‘[[dynamicValue]]’ business unit ‘[[dynamicValue]]’ does not exist
SoRL01OperationStatus is mandatory for IMPORT operation. Possible values: REJECTED / EXECUTED.
SoRL02OperationStatus must be empty for EVALUATE operation
SOV01SourceOfWealth [[dynamicValue]] is not defined in amlyze