> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mangopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/guides/users/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).

<table>
  <thead>
    <tr>
      <th class="header">Country</th>
      <th class="header">Country code</th>
      <th class="header">Name</th>
      <th class="header">Accepted formats</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td class="table-content">
        Andorra
      </td>

      <td class="table-content">
        AD
      </td>

      <td class="table-content">
        Número de comerç or núm registral de la societat
      </td>

      <td class="table-content">
        * 1 letter + 6 digits + 1 letter (LXXXXXXL)
        * 5 or 6 digits (XXXXX or XXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Argentina
      </td>

      <td class="table-content">
        AR
      </td>

      <td class="table-content">
        Número de Inscripción en el Registro Público de Comercio or Clave Única de Identificación Tributaria (CUIT)
      </td>

      <td class="table-content">
        * 11 digits
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Austria
      </td>

      <td class="table-content">
        AT
      </td>

      <td class="table-content">
        Firmenbuchnummer
      </td>

      <td class="table-content">
        * 2 letters + 6 digits + 1 letter (LLXXXXXXL)
        * 1 – 6 digits + 1 letter (XXXXXXL)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Belgium
      </td>

      <td class="table-content">
        BE
      </td>

      <td class="table-content">
        Vestigingseenheidsnummer or Numéro d'entreprise
      </td>

      <td class="table-content">
        * 10 digits (XXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Brazil
      </td>

      <td class="table-content">
        BR
      </td>

      <td class="table-content">
        CNPJ number or NIRE number
      </td>

      <td class="table-content">
        * 14 digits (XXXXXXXXXXXXXX)
        * 11 digits (XXXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Bulgaria
      </td>

      <td class="table-content">
        BG
      </td>

      <td class="table-content">
        ЕИК (EIK) or ПИК (PIK) (UIC/PIC)
      </td>

      <td class="table-content">
        * 9 digits (XXXXXXXXX)
        * 13 digits (XXXXXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Canada
      </td>

      <td class="table-content">
        CA
      </td>

      <td class="table-content">
        Business Number or Corporation Number
      </td>

      <td class="table-content">
        * 7 or 9 digits
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Chile
      </td>

      <td class="table-content">
        CL
      </td>

      <td class="table-content">
        Número de Registro de Comercio or Rol Único Tributario (RUT)
      </td>

      <td class="table-content">
        * 7 or 8 digits and 1 check digit (digit or letter K)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        China
      </td>

      <td class="table-content">
        CN
      </td>

      <td class="table-content">
        统一社会信用代码 (Uniform Credit Code (USCC)) or 工商注册号 (Registration Number)
      </td>

      <td class="table-content">
        * UCC: 18 characters
        * Registration number: 15 digits
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Croatia
      </td>

      <td class="table-content">
        HR
      </td>

      <td class="table-content">
        Matični broj poslovnog subjekta (MBS)
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
        * 9 digits (XXXXXXXXX)
        * 11 digits (XXXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Cyprus
      </td>

      <td class="table-content">
        CY
      </td>

      <td class="table-content">
        Αριθμός Μητρώου Εταιρίας Şirket kayıt numarası
      </td>

      <td class="table-content">
        * 2 letters + 5 digits (HEXXXXX)
        * 2 letters + 6 digits (HEXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Czechia
      </td>

      <td class="table-content">
        CZ
      </td>

      <td class="table-content">
        Identifikační číslo
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Denmark
      </td>

      <td class="table-content">
        DK
      </td>

      <td class="table-content">
        CVR-nummer
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Estonia
      </td>

      <td class="table-content">
        EE
      </td>

      <td class="table-content">
        Kood
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Finland
      </td>

      <td class="table-content">
        FI
      </td>

      <td class="table-content">
        Y-tunnus or FO-nummer
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        France
      </td>

      <td class="table-content">
        FR
      </td>

      <td class="table-content">
        SIREN or SIRET
      </td>

      <td class="table-content">
        * 9 digits (XXXXXXXXX)
        * 14 digits (XXXXXXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Germany
      </td>

      <td class="table-content">
        DE
      </td>

      <td class="table-content">
        Nummer der Firma Registernummer
      </td>

      <td class="table-content">
        * 2 – 3 letters + 6 digits (LLXXXXXX)
        * 2 – 3 letters + 1 – 6 digits (LLLXXXX)
        * 2 – 3 letters + 1 – 6 digits + 1 letter (LLLXXXXXXL)
        * 2 – 3 letters + 1 – 6 digits + 1 – 2 letter (LLLXXXXXXLL)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Greece
      </td>

      <td class="table-content">
        GR
      </td>

      <td class="table-content">
        τον Αριθμό Γενικού Εμπορικού Μητρώου or τον Αριθμό Φορολογικού Μητρώου (Α.Φ.Μ.)
      </td>

      <td class="table-content">
        * 12 digits (XXXXXXXXXXXX)
        * 9 digits (XXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Hong Kong
      </td>

      <td class="table-content">
        HK
      </td>

      <td class="table-content">
        商業登記號碼 (Business Registration Number)
      </td>

      <td class="table-content">
        * 8 digits
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Hungary
      </td>

      <td class="table-content">
        HU
      </td>

      <td class="table-content">
        Cégjegyzékszáma
      </td>

      <td class="table-content">
        * 2 letters + 10 digits (LLXXXXXXXXXX)
        * 10 digits (XXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Iceland
      </td>

      <td class="table-content">
        IS
      </td>

      <td class="table-content">
        TIN
      </td>

      <td class="table-content">
        * 10 digits (XXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        India
      </td>

      <td class="table-content">
        IN
      </td>

      <td class="table-content">
        Corporate Identification Number (CIN) or Goods and Services Tax Identification Number (GSTIN)
      </td>

      <td class="table-content">
        * 21 characters
        * 15 characters
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Ireland
      </td>

      <td class="table-content">
        IE
      </td>

      <td class="table-content">
        Company Registration Number (CRN)
      </td>

      <td class="table-content">
        * 6 digits (XXXXXX)
        * 5 digits (XXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Italy
      </td>

      <td class="table-content">
        IT
      </td>

      <td class="table-content">
        Codice fiscale or REA number
      </td>

      <td class="table-content">
        * 11 digits (XXXXXXXXXXX)
        * 2 letters + 7 digits (LLXXXXXXX)
        * 2 letters + 6 digits (LLXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Japan
      </td>

      <td class="table-content">
        JP
      </td>

      <td class="table-content">
        法人番号, Hōjin Bangō (Corporate Number)
      </td>

      <td class="table-content">
        * 13 or 12 digits
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Latvia
      </td>

      <td class="table-content">
        LV
      </td>

      <td class="table-content">
        Reģistrācijas numurs
      </td>

      <td class="table-content">
        * 11 digits (XXXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Liechtenstein
      </td>

      <td class="table-content">
        LI
      </td>

      <td class="table-content">
        UID
      </td>

      <td class="table-content">
        * 3 letters + 9 digits (LLLXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Lithuania
      </td>

      <td class="table-content">
        LT
      </td>

      <td class="table-content">
        Juridinio asmens kodas
      </td>

      <td class="table-content">
        * 9 digits (XXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Luxembourg
      </td>

      <td class="table-content">
        LU
      </td>

      <td class="table-content">
        Numéro d'immatriculation
      </td>

      <td class="table-content">
        * 1 letter + 6 digits (LXXXXXX)
        * 1 letter (from A to J) + 3 – 6 digits
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Malta
      </td>

      <td class="table-content">
        MT
      </td>

      <td class="table-content">
        Registration Number
      </td>

      <td class="table-content">
        * 1 letter + 5 digits (LXXXXX)
        * 1 letter + 6 digits (LXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Montenegro
      </td>

      <td class="table-content">
        ME
      </td>

      <td class="table-content">
        Matični broj / Registarski broj or Poreski Identifikacioni Broj (9 digits)
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
        * 9 digits (XXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Morocco
      </td>

      <td class="table-content">
        MA
      </td>

      <td class="table-content">
        ICE number or RC number
      </td>

      <td class="table-content">
        * 15 digits (XXXXXXXXXXXXXXX)
        * 6 to 8 digits
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Netherlands
      </td>

      <td class="table-content">
        NL
      </td>

      <td class="table-content">
        KvK-nummer
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        New Zealand
      </td>

      <td class="table-content">
        NZ
      </td>

      <td class="table-content">
        New Zealand Business Number (NZBN) or Company Number issued by the companies office
      </td>

      <td class="table-content">
        * 13 digits (XXXXXXXXXXXXX)
        * 6 to 8 digits
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Norway
      </td>

      <td class="table-content">
        NO
      </td>

      <td class="table-content">
        TIN
      </td>

      <td class="table-content">
        * 11 digits (XXXXXXXXXXX)
        * 9 digits (XXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Peru
      </td>

      <td class="table-content">
        PE
      </td>

      <td class="table-content">
        Número de Inscripción en el Registro Público de Comercio or
        Registro Único de Contribuyentes (RUC)
      </td>

      <td class="table-content">
        * 11 digits
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Poland
      </td>

      <td class="table-content">
        PL
      </td>

      <td class="table-content">
        Numer w Krajowym Rejestrze Sądowym (numer KRS)
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
        * 6 digits (XXXXXX)
        * 9 digits (XXXXXXXXX)
        * 10 digits (XXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Portugal
      </td>

      <td class="table-content">
        PT
      </td>

      <td class="table-content">
        Número de Identificação Pessoa Coletiva (NIPC)
      </td>

      <td class="table-content">
        * 9 digits (XXXXXXXXX)
        * 3 – 6 digits (XXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Romania
      </td>

      <td class="table-content">
        RO
      </td>

      <td class="table-content">
        Număr de ordine în Registrul Comerţului
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Serbia
      </td>

      <td class="table-content">
        RS
      </td>

      <td class="table-content">
        Matični broj (Company Registration Number) or Poreski Identifikacioni Broj (PIB)
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
        * 9 digits (XXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Slovakia
      </td>

      <td class="table-content">
        SK
      </td>

      <td class="table-content">
        Identifikačného čísla Identification number
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Slovenia
      </td>

      <td class="table-content">
        SI
      </td>

      <td class="table-content">
        Matična številka
      </td>

      <td class="table-content">
        * 10 digits (XXXXXXXXXX)
        * 7 – 10 digits (XXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        South Africa
      </td>

      <td class="table-content">
        ZA
      </td>

      <td class="table-content">
        Registration Number
      </td>

      <td class="table-content">
        * 13 digits
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Spain
      </td>

      <td class="table-content">
        ES
      </td>

      <td class="table-content">
        Número de identificación fiscal (NIF)
      </td>

      <td class="table-content">
        * 1 letter + 8 digits (LXXXXXXXX)
        * 1 letter + 7 digits + 1 letter (LXXXXXXXL)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Sweden
      </td>

      <td class="table-content">
        SE
      </td>

      <td class="table-content">
        Organisationsnummer
      </td>

      <td class="table-content">
        * 10 digits (XXXXXXXXXX, optional dash XXXXXX-XXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        Switzerland
      </td>

      <td class="table-content">
        CH
      </td>

      <td class="table-content">
        UID
      </td>

      <td class="table-content">
        * 9 digits (XXXXXXXXX)
        * CHE + 9 digits (CHEXXXXXXXXX)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        United Arab Emirates (UAE)
      </td>

      <td class="table-content">
        GB
      </td>

      <td class="table-content">
        (رقم الرخصة) Trade License Number
      </td>

      <td class="table-content">
        * 7 or 8 digits
      </td>
    </tr>

    <tr>
      <td class="table-content">
        United Kingdom (UK)
      </td>

      <td class="table-content">
        GB
      </td>

      <td class="table-content">
        Company Number or Registration Number
      </td>

      <td class="table-content">
        * 8 digits (XXXXXXXX)
        * 7 digits (XXXXXXX)
        * OC + 6 digits (OCXXXXXX)
        * SC + 6 digits (SCXXXXXX)
        * SO + 6 digits (SOXXXXXX)
        * NI + 6 digits (NIXXXXXX)
        * R + 7 digits (RXXXXXXX)
        * IP + 5 digits + R (IPXXXXXR)
      </td>
    </tr>

    <tr>
      <td class="table-content">
        United States
      </td>

      <td class="table-content">
        US
      </td>

      <td class="table-content">
        Employer Identification Number (EIN) or state Entity Number
      </td>

      <td class="table-content">
        * EIN: 9 digits (XXXXXXXXX)
        * Entity Number format depends on the state
      </td>
    </tr>
  </tbody>
</table>

## 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](/api-reference/user-data-format/validate-user-data-format).

There are also two [webhook](/webhooks) 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_SUCCEEDED`
* `LEGAL_COMPANY_NUMBER_VALIDATION_FAILED`

These hooks can be triggered by the following calls:

* [POST Create a Legal User (SCA)](/api-reference/users/create-legal-user-sca)
* [PUT Categorize a Legal User](/api-reference/users/categorize-legal-user)
* [PUT Update a Legal User (SCA)](/api-reference/users/update-legal-user-sca)

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)

## Related resources

<CardGroup col={2}>
  <Card title="Endpoint" href="/api-reference/user-data-format/validate-user-data-format">
    Validate the format of User data
  </Card>

  <Card title="Endpoint" href="/api-reference/users/legal-user-object-sca">
    The Legal User object
  </Card>

  <Card title="Webhooks" href="/webhooks/event-types">
    Learn more about event types
  </Card>
</CardGroup>