Appearance

Errors ​

The following API errors can be encountered when dealing with user verification.

Warning icon

Caution – Only the legacy API sends the error code in HTTP errors

When handling errors with Connect, only the message attribute is returned.

KYC request errors ​

CodeMessage
1Generic Error
3A database error has occured
6An Exception has been raised
11One filter given in the request is empty, you should provide a filter value at least
31The same request is already running
55The request accessTag is too long
1029Non-existent client for the given user
10009Request UserId does not belong to Oauth2 ClientId
10029Non-existent client for the given document
10030SCI must be between 8 and 35 characters
10034SCI must start with a valid ISO country code
10035Invalid SCI checksum
11004Title is required
11005Civility value must be either 'M' or 'MME' or 'MLLE'
11006Firstname is required.
11007The lastname is required.
11011The post code is required.
11012The city is required.
11013The country is required. Format ISO 3166-1 alpha-2
11019The email is already used
11025legalRegistrationNumber is required.
11026legalRegistrationDate is required (format : YYYY-MM-DD)
11027legalName is required.
11028legalForm is required.
11029legalShareCapital is required
11030phone is required.
11031legalSector is required.
11032legalNumberOfEmployeeRange is required.
11033legalNetIncomeRange is required.
11034legalAnnualTurnOver is required.
11035placeOfBirth is required.
11036birthCountry is required. Format ISO 3166-1 alpha-2
11037nationality is required.
11039birthday is required (format : YYYY-MM-DD)
11040userIdKyc is required.
11041user does not exist.
11042kycReview is required.
11043kycReview value is incorrect.
11044kycReviewComment is required.
11046userIdKyc is required.
11047user does not exist.
11048kycLevel is required.
11049kycLevel value is incorrect.
11051nationalityOther is not in the right format. Format ISO 3166-1 alpha-2
11058birthday is not in the right format. Format YYYY-MM-DD
11060nationality is not in the right format. Format ISO 3166-1 alpha-2
11073incomeRange is required.
11074userId is missing.
11075userId does not exist for the client.
11076sci is empty
11095employeeType is missing
11098controllingPersonType is missing
11099specifiedUSPerson is missing
11113Wrong value of legalForm for user type NATURAL PERSON, legalForm can only be 1000.
11115legalRegistrationDate Year is too old (before 1800)
11122The secondary address is required
11123The secondary country is required
11124The secondary postcode is required
11125The secondary city is required
101300the business user and each effective beneficiary attached to it need to have at least one tax residence declared
101301the business user and each effective beneficiary attached to it need to have at least one valid tax residence declared
101208specifiedUSPerson must be 0 or 1

Document errors ​

CodeMessage
60000The user does not exist or he is in canceled status
60001File not uploaded. The file is empty
60002The file type is not permitted
60003This document type is not permitted
60004Impossible to save the document
60005Impossible to connect to the file server
60006Impossible to upload the document into the container
60007Impossible to read the file into the container
60008Impossible to update the document into database
60009Error when reading document
60010Impossible to cancel this Document, already in CANCELED status
60011Impossible to update this Document, not exists
60012statusId incorrect.
60013Impossible to verify canceled status
60014Impossible to update this document
60017Image is empty
60019documentId is mandatory.
60020documentStatusId is mandatory.
60021The document must be in a PENDING status
60024The documentTypeId is empty or you provide a wrong documentTypeId value
60025Wrong value for documentStatusId
60026documentId not valid
60027statusId is mandatory.
60028When the document is a taxStatement or an exemptionStatement, the field residenceId is mandatory
60029When the document is not a taxStatement nor an exemptionStatement, the field residenceId should not be provided
60030The residenceId you provided does not match a valid entry in the taxResidence database
60031The residenceId you provided has been deleted
60032userId is missing
60033Impossible to create the document, The number of objects is exceeded or the quota of your space is saturated
60034Impossible to update the status, this document is canceled
60035Impossible to get URL, this document does not exist
60036The document source is not valid or not in the list
60038name is mandatory.
60039Document not found in database.
60040Update document status with error
60041fileExtension is missing
60042FileExtension is not valid or not in the list
60043The request must contain documentHash when documentId is in params .
60044Document already cancel or validate, this document, this document is not pending status
60045The documentHash is invalid
60046fileExtension is not correct

Tax Residence errors ​

CodeMessage
101001taxPayerId and liabilityWaiver are both present
101002taxResidence doesn't exist
101003Country is not in the following format: ISO 3166-1 alpha 2
101004taxPayerId is invalid
101005taxResidence is deleted, impossible to update this taxResidence
101006taxPayerId and liabilityWaiwer at least one must be present
101200liabilityWaiver cannot be false if taxPayerId is null or empty
101201liabilityWaiver cannot be true if taxPayerId is not null or not empty
101202a taxPayerId is required if country is US or a US territory
101203the country must have a ISO 3166-1 alpha 2 format
101204a tax residence in the US or a US teritory must be declared for the user if specifiedUSPerson = 1
101205specifiedUSPerson must be 1 if at least one of the following fields is the US or a US territory: nationality, nationalityOther, birthCountry, country, secondaryCountry
101206specifiedUSPerson must be 1 if a tax residence was declared in the US or a US territory
101207a user must have at least one tax residence declared
101213The user can't waive liability, taxPayerId is required.
101214An Italian taxPayerId already exists for this user.
101215Updating the userId is not allowed.
101216Updating the country is not allowed.
101217Tax Residence can't be deleted, the taxPayerId is required for the associated User.
101218The taxPayerId from the Tax Residence object is mandatory for Italian users.