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, such as spaces or hyphen-dashes (-), sometimes used as separators 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 | Code | Name | Accepted formats |
|---|---|---|---|
| Austria | AT | Firmenbuchnummer |
|
| Belgium | BE | Vestigingseenheidsnummer or Numéro d’entreprise |
|
| Bulgaria | BG | ЕИК (EIK) or ПИК (PIK) (UIC/PIC) |
|
| 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 τον Αριθμό Φορολογικού Μητρώου (Α.Φ.Μ.) |
|
| Hungary | HU | Cégjegyzékszáma |
|
| Iceland | IS | TIN |
|
| Ireland | IE | Company Registration Number (CRN) |
|
| Italy | IT | Codice fiscale or REA 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 Kingdom | GB | Company Number or Registration 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)