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).
| Country | Country code | Name | Accepted formats |
|---|---|---|---|
| Austria | AT | Firmenbuchnummer |
|
| Belgium | BE | Vestigingseenheidsnummer or Numéro d’entreprise |
|
| Bulgaria | BG | ЕИК (EIK) or ПИК (PIK) (UIC/PIC) |
|
| Canada | CA |
|
|
| China | CN | 统一社会信用代码 (Uniform Credit Code (USCC)) or 工商注册号 (Registration Number) |
|
| Croatia | HR | Matični broj poslovnog subjekta (MBS) |
|
| Cyprus | CY | Αριθμός Μητρώου Εταιρίας Şirket kayıt numarası |
|
| Czechia | CZ | Identifikační číslo |
|
| Denmark | DK | CVR-nummer |
|
| Estonia | EE | Kood |
|
| Finland | FI | Y-tunnus or FO-nummer |
|
| France | FR | SIREN or SIRET |
|
| Germany | DE | Nummer der Firma Registernummer |
|
| Greece | GR | τον Αριθμό Γενικού Εμπορικού Μητρώου or τον Αριθμό Φορολογικού Μητρώου (Α.Φ.Μ.) |
|
| Hong Kong | HK | 商業登記號碼 (Business Registration Number) |
|
| Hungary | HU | Cégjegyzékszáma |
|
| Iceland | IS | TIN |
|
| Ireland | IE | Company Registration Number (CRN) |
|
| Italy | IT | Codice fiscale or REA number |
|
| Japan | JP | 法人番号, Hōjin Bangō (Corporate Number) |
|
| Latvia | LV | Reģistrācijas numurs |
|
| Liechtenstein | LI | UID |
|
| Lithuania | LT | Juridinio asmens kodas |
|
| Luxembourg | LU | Numéro d’immatriculation |
|
| Malta | MT | Registration Number |
|
| Netherlands | NL | KvK-nummer |
|
| Norway | NO | TIN |
|
| Poland | PL | Numer w Krajowym Rejestrze Sądowym (numer KRS) |
|
| Portugal | PT | Número de Identificação Pessoa Coletiva (NIPC) |
|
| Romania | RO | Număr de ordine în Registrul Comerţului |
|
| Slovakia | SK | Identifikačného čísla Identification number |
|
| Slovenia | SI | Matična številka |
|
| Spain | ES | Número de identificación fiscal (NIF) |
|
| Sweden | SE | Organisationsnummer |
|
| Switzerland | CH | UID |
|
| United Arab Emirates (UAE) | GB | (رقم الرخصة) Trade License Number |
|
| United Kingdom (UK) | GB | Company Number or Registration Number |
|
| United States | US | Employer Identification Number (EIN) or state Entity Number |
|
Format validation
In some cases for a Business-type user, an incorrect format for theCompanyNumber 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
Note – Endpoint and webhooks supported by limited set of country codesThe regexes in place to validate format is not in place for some of the countries listed above. For unsupported countries, webhook notifications are not sent and the endpoint returns a messaging explaining that there are no validation rules in place.
- 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)