Company number
The company number is the legal registration number of an entity provided by the relevant national authority in the country where it is registered.
The company number is one of the elements checked during the user verification process. The number is required for Business-type legal users, and recommended for Soletraders and Organizations if it exists. See the verification requirements for details.
The CompanyNumber should be in the correct format for their country of registration, as determined by the Country of the HeadquartersAddress.
Accepted format by country
The table below details the name and typically accepted format of a company registration number in each country.
Special characters sometimes used as separators – such as spaces, hyphens, or dashes (-) – should not be provided in the Legal User object of the API. They may appear as optional below for the purposes of manual validation (if they commonly appear in the registration proof, for example).
Format validation
In some cases for a Business-type user, an incorrect format for the CompanyNumber can delay or prevent the KYCLevel from changing to REGULAR even if all KYC Documents and the UBO Declaration have been validated.
Your platform can proactively check that a user’s registration number is correct by calling the POST Validate the format of User data.
There are also two webhook event types that your platform can set up to be notified when a user’s number corresponds or not to the expected format:
LEGAL_COMPANY_NUMBER_VALIDATION_SUCCEEDEDLEGAL_COMPANY_NUMBER_VALIDATION_FAILED
These hooks can be triggered by the following calls:
Note the following regarding this format validation feature:
- Only the format is validated by the regex rules in place behind the endpoint and webhooks. The veracity of the number is checked later during verification after the supporting documents are submitted.
- The regex rules are only in place for the countries listed below. For unsupported countries, webhook notifications are not sent and the endpoint returns a messaging explaining that there are no validation rules in place.
- The consistency between the declared company number and the submitted documentation is always verified, regardless of the regex rules.
The list of countries for which regex rules are in place to validate the format is:
- Austria (AT)
- Belgium (BE)
- Bulgaria (BG)
- Croatia (HR)
- Cyprus (CY)
- Czechia (CZ)
- Denmark (DK)
- Estonia (EE)
- Finland (FI)
- France (FR)
- Germany (DE)
- Greece (GR)
- Hungary (HU)
- Iceland (IS)
- Ireland (IE)
- Italy (IT)
- Latvia (LV)
- Liechtenstein (LI)
- Lithuania (LT)
- Luxembourg (LU)
- Malta (MT)
- Netherlands (NL)
- Norway (NO)
- Poland (PL)
- Portugal (PT)
- Romania (RO)
- Slovakia (SK)
- Slovenia (SI)
- Spain (ES)
- Sweden (SE)
- Switzerland (CH)
- United Kingdom (GB)