Errors

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

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

User errors

The following API errors can be encountered when dealing with users.

Code	Message
28	User's assets are freezed
10012	User Canceled
10023	UserId is in pending state
10025	UserId is in invalid state
11002	Unable to update the user. User does not exist
11008	The email is required.
11009	The email is not valid.
11010	The address is required
11013	The country is required. Format ISO 3166-1 alpha-2
11014	Impossible to cancel, the user does not exist.
11015	Impossible to cancel, the origin not specified or incorrect.
11016	Impossible to cancel user, he is already in canceled status.
11017	Impossible to cancel user. Wrong userId.
11018	Impossible to cancel user. Database error
11019	The email is already used
11020	Impossible to create user. The parent type must be provided
11021	Impossible to create user. Value available for Parent Type : shareholder, employee, leader
11022	Impossible to create user. Parent User does not exist
11023	Impossible to update the kyc review. User does not exist.
11024	legalRegistrationNumber is not valid.
11025	legalRegistrationNumber is required
11027	legalName is required.
11028	legalForm is required.
11030	phone is required.
11035	placeOfBirth is required.
11038	userTypeId is required.
11041	user does not exist.
11042	kycReview is required.
11043	kycReview value is incorrect.
11044	kycReviewComment is required.
11046	userIdKyc is required.
11047	user does not exist.
11048	kycLevel is required.
11049	kycLevel value is incorrect.
11053	legalForm does not exist
11054	legalNumberOfEmployeeRange is not correct. Values authorized :
11055	legalNetIncomeRange is not correct. Values authorized :
11056	legalAnnualTurnOver is not correct. Values authorized :
11057	title is not correct. Values authorized
11058	birthday is not in the right format. Format YYYY-MM-DD
11059	birthCountry is not in the right format. Format ISO 3166-1 alpha-2
11061	nationalityOther is not in the right format. Format ISO 3166-1 alpha-2
11062	Impossible to update the kyc review. KYC entity is not created
11063	Impossible to update the kyc review. Phone number can not contains a space character. It can begin by the
11077	sci must be between 17 and 35 characters
11078	The language provided does not comply with ISO 639 (alpha-2) norm.
11080	The field 'personalAssets' must have a value compliant with the documentation
11081	The format must follow the norm : ISO-3166-1 alpha-2
11085	The field 'personalAssets' is provided but the value does not comply with provided enum values
11086	User is not found in the database
11087	Wrong format for phone number.
11088	Wrong format for mobile number.
11089	User's address1 has a line breaker
11090	User's address2 has a line breaker
11092	User's address3 has a line breaker
11093	User is not found in the database
11094	User is not found in the database
11096	employeeType is invalid
11097	controllingPersonType is invalid
11100	specifiedUSPerson is provided but are not between 0 and 1
11101	entityType is invalid
11102	activityOutsideEu is provided but are not between 0 and 1
11103	economicSanctions is provided but are not between 0 and 1
11104	residentCountriesSanctions is provided but are not between 0 and 1
11105	involvedSanctions is provided but are not between 0 and 1
11109	timezone is not in the right format. Format type tz database. Ex : Europe/Paris
11110	User's city has a line breaker
11111	User's country has a line breaker
11112	Error during the user's cards update, please try again later
11113	Wrong value of legalForm for user type NATURAL PERSON, legalForm can only be 1000.
11114	BirthDepartementCode is not in the right format. Format type : 5 digits. Ex : 75008
11115	legalRegistrationDate Year is too old (before 1800)
11116	legalForm is not valid.
11117	User's email is too long, it must not exceed 50 characters
11118	User's secondary address1 has a line breaker
11119	User's secondary address2 has a line breaker
11120	occupation field must be a string
11121	The format must follow the norm : ISO-3166-1 alpha-2
11122	The secondary address is required
11126	User's secondary address3 has a line breaker
11127	isOnStockExchange is provided but are not between 0 and 1
11128	occupationType is not correct. Values authorized : self_employed, public_sector_employees, private_sector_employees, retired_people_and_students, without_any_professional_activity
11129	sourceOfFunds is not correct. Values authorized : donation, inheritance, loan, lottery, pension, proceeds_from_investment, proceeds_from_sale, salary, saving
11133	Impossible to update Legal Freeze field.
11134	legalSectorType is not correct. Values authorized : NAF, NACE
11135	legalSector is not in the correct format for a legalSectorType code : NAF => [0-9][0-9][0-9][0-9][A-Z] or NACE => [0-9][0-9][0-9][0-9]
11141	Impossible to cancel user, pending card authorization.
11141	not a valid French city
11142	An error occurred while processing cancel request, aborting.
11142	incoherent French city and postcode
11143	not a valid French postcode
11144	A legal user can't give the firstname
11145	A legal user can't give the lastname
11146	A legal user can't give the middleNames
11148	firstname is too long
11149	lastname is too long
11151	firstname is invalid
11152	lastname is invalid
11153	middleNames is invalid
11157	incoherent legalForm for this userType
11177	Impossible to submit KYC request due to user status
11181	too many characters for the placeOfBirth field
11182	characters not accepted for placeOfBirth
11183	too many characters for an address field
11184	too many characters for an address2 field
11185	too many characters for an address3 field
11186	characters not accepted for an address field
11187	characters not accepted for an address2 field
11188	characters not accepted for an address3 field
11189	Birthday is not valid
11190	Wrong value of legalForm for user type NATURAL PERSON, legalForm can only be 10001.
11191	city or postCode does not exist
11192	city and postCode are not consistent
11193	Wrong value of legalForm for user type NATURAL PERSON, legalForm can only be 20001.
11194	A legal user can't give birthday
11196	legalName is not valid
11197	The legalName field is not applicable for NATURAL user
11198	legalName is not valid
11199	The legalName field is not applicable for NATURAL user
11200	Wrong value of legalForm for user type NATURAL PERSON, legalForm can only be 30001.
11201	The occupation field is not applicable for legal users
11202	occupation is not valid
11204	secondaryCity or secondaryPostCode does not exist
11205	secondaryCity and secondaryPostCode are not consistent
11206	legalTvaNumber is not valid
11207	The legalTvaNumber field is not applicable for NATURAL user
11208	legalTvaNumber is required
11209	legalRegistrationDate is not valid.
11210	The legalRegistrationDate field is not applicable for NATURAL user
11211	too many characters for a secondary address 1 field
11212	too many characters for a secondary address 2 field
11213	too many characters for a secondary address 3 field
11214	not enough characters for a secondaryAddress1 field
11215	not enough characters for a secondaryAddress2 field
11216	not enough characters for a secondaryAddress3 field
11217	not enough characters for an address field
11218	not enough characters for an address2 field
11219	not enough characters for an address3 field
11220	legalNumberOfEmployeeRange is invalid.
11221	legalAnnualTurnOver is invalid.
11222	characters not accepted for a secondaryAddress1 field
11223	characters not accepted for a secondaryAddress2 field
11224	characters not accepted for a secondaryAddress3 field
11225	Wrong value of legalForm for user type NATURAL PERSON, legalForm can only be 40001.
11226	Wrong value of legalForm for user type NATURAL PERSON, legalForm can only be 50001.
11227	Wrong value of legalForm for user type NATURAL PERSON, legalForm can only be 60001.
11228	The values of legalSector and userTypeId are incompatible
11229	legalForm is not valid. The country is needed for more precision.
101209	The distributionCountry must follow the ISO-3166-1 alpha-2 format
101210	The distributionCountry is required
101211	The DistributionCountry needs to be listed on the client side
101212	Client DistributionCountry is missing
101302	not an acceptable value for personalAssetsRange
101305	The user field placeOfBirth is invalid

User Relationships errors

The following API errors can be encountered when dealing with User Relationships.

HTTP	Message	Description
400	value is not valid for this role	The relationshipTypeId doesn't require a value, or the value format is invalid.
400	role not found	The relationshipTypeId doesn't exist.
400	userId and relatedUserId must be different	The sourceUserId and targetUserId must be different.
403	Request RelatedUserId does not belong to Oauth2 ClientId	The sourceUserId doesn't exist.
403	Request UserId does not belong to Oauth2 ClientId	The targetUserId doesn't exist.
409	relationship already exists	The relationship between the users already exists. You must delete the existing relationship to recreate one.

User restriction errors

The following API errors can be encountered when dealing with Restricted Users.

Code	Message
11064	Impossible to Freeze Assets. userId is mandatory.
11065	Impossible to Freeze Assets. userIdFreezed does not exist.
11066	Impossible to Freeze Assets. isFrozen is mandatory.
11067	User's assets already freezed
11068	User's assets already not freezed
11069	Impossible to Freeze Assets. comment is mandatory.
11130	User's assets already legally frozen
11131	User's assets already not legally frozen
11132	IsLegalFrozen is provided but are not between 0 and 1
11133	Impossible to update Legal Freeze field.

Tax Residence errors

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