Validation errors

Here is a list of possible validation error messages that can be returned on Identity creation or update.
Error messages are returned in errors section. There can be multiple error messages in one response. General error response example:

{
    "type": "https://tools.ietf.org/h....1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "traceId": "00-7cb17939b823f1e1d0c7d1a5f5ea6173-b8ec4507b0253632-00",
    "errors": {
        "LegalStructure": [
            "Legal structure is invalid"
        ],
        "Address.Country": [
            "'Country' is not valid"
        ],
        "Address.Street2": [
            "'Street2' is too long"
        ]
    }
}

Personal Validation Errors

Parameter to validateCodeValidation error
Email is not provided400"Email": ["'Email' is null or empty"]
Email is invalid400"Email": ["'Email' is not a valid email address"] Must be unique within Organization
FirstName is not provided400"FirstName": ["'First Name' must not be empty."]
First name >100 symbols400"FirstName": ["'First Name' is too long"]
LastName is not provided400"LastName": ["'Last Name' must not be empty."]
LastName >100 symbols400"LastName": ["'Last Name' is too long"]
MiddleName > 100 symbols400"MiddleName": ["'Middle Name' is too long"]
Phone is not provided400"Phone": ["Phone is not valid"]
Phone>20 characters400"Phone": ["'Phone' is not valid", "'Phone' must be between 1 and 20 characters. You entered 21 characters."]

E-164 Format [+][country code][area code][local phone number] Must be unique within Organization
Phone number is VoIP400"errors": {"5a0b8ca6-5cf3-4133-b430-d4a77cfd5dc7": ["Identity wasn't created as provided Phone Number type is VoIP."]}, "title": "Identity wasn't created as provided Phone Number type is VoIP."
SSN - social security number400"Ssn": ["The specified condition was not met for 'Ssn'."]

Format: "AAAGGSSSS" Must be unique within Organization
DateOfBirth400"DateOfBirth": ["The specified condition was not met for 'Date Of Birth'."]

Format: yyyy-mm-dd
Address400"Address.Street1": ["'Street1' must not be empty."]
Address.PostalCode is missing400"Address.PostalCode": ["'Postal Code' must not be empty."]
Address.PostalCode has invalid format400"errors": {"Address.PostalCode": ["'Postal Code' is not in the correct format."]}

Format: US: 5 digits. Other counties: digits and letters (min 4 max 34). no special symbols and spaces. Exception: countries without postal codes
Address.State is not provided (if US)400"Address.State": ["'State' must not be empty.", "The specified condition was not met for 'State'."]

2 letter abbreviation
Address.State is invalid400"Address.State": ["'State' is not valid"]
Address.State = 2 symbols400"Address.State": ["'State' is too long"]
Address.City is not provided400"Address.City": ["'City' must not be empty."]
Address.City > 35 symbols400"Address.City": ["'City' is too long"]
Address.street1400"Address.Street1": ["'Street1' must not be empty."]
Address.street1 > 100 symbols400"Address.Street1": ["'Street1' is too long"]
Address.street2 > 100 symbols400"Address.Street2": ["'Street2' is too long"]
Address.Country is missing400"Address.Country": ["'Country' must not be empty."]
Address.Country is invalid400"Address.Country": ["'Country' is not valid"]
Identity with duplicated SSN is found409"errors": {"54b1f5cc-f44d-44fe-976b-2a642c8b67e7": ["Validation error"]}, "title": "The identity with ssn '123-45-4625' already exists in current organization"
Identity with duplicated Phone is found409"title": "The identity with phone '+12027781111' already exists in current organization"
Identity with duplicated Email is found409"title": "The identity with email '[email protected]' already exists in current organization"
Simultaneous creation of duplicated identities409"title": "This item already exists."

Business Validation Errors

ParameterCodeDescription
CompanyName is missing400"errors": {"CompanyName": ["'Company Name' must not be empty."]}
CompanyName >60 characters400"CompanyName": ["'Company Name' must be between 1 and 60 characters. You entered 61 characters."]
Phone number is invalid400"Phone": ["'Phone' is not valid", "'Phone' must be between 1 and 20 characters. You entered 21 characters."]
Website400"Website": ["'Website' must be between 1 and 100 characters. You entered 101 characters."]
EIN is not provided if country is US400"Ein": ["'Ein' must not be empty."]
EIN is not valid400"Ein": ["The specified condition was not met for 'Ein'."]
Email is missing400"Email": ["'Email' must not be empty.", "The specified condition was not met for 'Email'."]
Email is invalid400"Email": ["'Email' is not a valid email address."]
Address400"Address": ["'Address' must not be empty."]
Address.Street1400"Address.Street1": ["'Street1' must not be empty."]
Address.Street2400"Address.Street2": ["'Street2' is too long"]
Address.City400"Address.City": ["'City' must not be empty."]
Address.Country400"Address.Country": ["'Country' must not be empty.", "'Country' is not valid"]
Address.State400"Address.State": ["'State' must not be empty.", "'State' is not valid"]
Address.PostalCode400"Address.PostalCode": ["'Postal Code' must not be empty."]
RegionOfFormation is not provided400"RegionOfFormation": ["'Region Of Formation' must not be empty."]
Description is not provided400"Description": ["'Description' must not be empty."]
EstablishedOn is not provided400"errors": {"EstablishedOn": ["'Established On' must not be empty."]}
LegalStructure is not provided400"LegalStructure": ["LegalStructure is required"]
MailingAddressOptional
MailingAddress.Street1 is missing if MailingAddress section is provided400"MailingAddress.Street1": ["'Street1' must not be empty.", "'Street1' is not valid"]
MailingAddress.Street1 >100 symbols400"MailingAddress.Street1": ["'Street1' is too long"]
MailingAddress.Street2 >100 symbols400"errors": {"MailingAddress.Street2": ["'Street2' is too long"]}
MailingAddress.Country is missing400"errors": {"MailingAddress.Country": ["'Country' must not be empty.", "'Country' is not valid"]}
MailingAddress.State is missing400'State' must not be empty. / 'State' is not valid
MailingAddress.State is invalid400'State' is not valid
MailingAddress.State is invalid > 35 symbols400'State' is too long
MailingAddress.PostalCode is missing400'Postal Code' must not be empty. / 'Postal Code' is not in the correct format.
MailingAddress.PostalCode is invalid400'Postal Code' is not in the correct format.
Identity Container Id is missing400'identityContainerId' is required. Should be type of Guid
Number of beneficial owners >5400beneficial owners exceeds the max limit of 5
EIN check Failed400Business Identity can't be created as Taxpayer Identification Numbers check was failed.
Duplicated EIN409The Business Identity with EIN '12-3456769' already exists in current organization
Provided Personal Identity is Suspended400Operation is not allowed with suspended identity