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

# Italian company identifier changed from codice fiscale to REA

> Italian company identifiers in V2 API now use REA (provincial registry numbers) instead of Codice Fiscale for unique company identification.

## Overview

This update changes how Italian company identifiers are structured in API responses, transitioning from using Codice Fiscale (a non-unique national identifier for companies) to using provincial registry numbers (REA - Repertorio Economico Amministrativo). For developers using V2's KyckrId-based approach for subsequent API calls, this change should be transparent and require no code modifications. However, systems that directly store or process company identifiers will need to be updated to handle the new format.

### Italy company identifiers

| Type Code   | Format             | Length       | Pattern               | Description                                                                            | Example                  | Notes                                                                                                                              |
| ----------- | ------------------ | ------------ | --------------------- | -------------------------------------------------------------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| IT\_REA\_CD | 2 letters + digits | 2 + variable | \[A-Z]{2}\d+          | Trade register number (REA). Consists of province code followed by registration number | NA0091712                | Province code (e.g. NA=Naples) followed by unique registration number. Each Chamber of Commerce (CCIAA) maintains its own register |
| IT\_VAT\_CD | IT + 11 digits     | 13           | IT\d{11}              | European VAT number                                                                    | IT12345678912            | Italian VAT numbers always start with IT prefix followed by 11 digits                                                              |
| IT\_TAX\_CD | 16 characters      | 16           | For companies: \d{11} | Tax identification code (Codice Fiscale)                                               | For company: 12345678901 | For companies: 11 digits                                                                                                           |

## Key changes

* **Search Response**: Modified the `companyNumber` field to use the REA number (IT\_REA\_CD)
* **Lite Profile**: Updated company identifier fields to reflect the REA identification system
* **Enhanced Profile**: Adjusted identifier structure to maintain consistency with search and lite profile changes

## Technical details

### Search methods

The Company Search API supports three methods for searching Italian companies:

1. **Name Search**: Search by company name
2. **REA**: Search using the REA (IT\_REA\_CD) format
3. **Codice Fiscale**: Search using the national tax number (IT\_TAX\_CD) - may return multiple entity matches

### Response field changes

#### V2 API

The search response fields have been updated to support the REA identification system:

* `companyNumber`: Now contains the REA (IT\_REA\_CD) format
* `identifiers.primaryRegistrationNumber`: Contains the REA (IT\_REA\_CD) format
* `identifiers.secondaryRegistrationNumber`: Contains the Codice Fiscale (IT\_TAX\_CD)
* `otherIdentifiers`: \[Future] For Lite and Enhanced Profile, new array containing standardized identifiers with their type codes

### Example responses

#### Search response

Before:

```json theme={null}
{
  "data": [{
    "id": "IT|MDA2ODUwODA0MjZ8QU4",
    "companyName": "ACME Trading S.R.L.",
    "companyNumber": "123456",
    "registrationAuthority": "MILANO"
  }]
}
```

After:

```json theme={null}
{
  "data": [{
    "id": "IT|TUkxMjM0NTZ8TUk",
    "companyName": "ACME Trading S.R.L.",
    "companyNumber": "MI123456",
    "registrationAuthority": "MILANO"
  }]
}
```

#### Lite Profile

Before:

```json theme={null}
{
  "data": {
    "companyNumber": "12345678901",
    "secondaryCompanyNumber": "123456",
    "companyName": "ACME Trading S.R.L.",
    "registrationAuthority": "MILANO",
    "registrationAuthorityCode": "MI"
  }
}
```

After:

```json theme={null}
{
  "data": {
    "companyNumber": "MI123456",
    "secondaryCompanyNumber": "12345678901",
    "otherIdentifiers": [
      { "type": "IT_TAX_CD", "value": "12345678901" }
    ],
    "companyName": "ACME Trading S.R.L.",
    "registrationAuthority": "MILANO",
    "registrationAuthorityCode": "MI"
  }
}
```

#### Enhanced Profile

Before:

```json theme={null}
{
  "data": {
    "identifiers": {
      "primaryRegistrationNumber": "12345678901",
      "secondaryRegistrationNumber": "MI123456"
    }
  }
}
```

After:

```json theme={null}
{
  "data": {
    "identifiers": {
      "primaryRegistrationNumber": "MI123456",
      "secondaryRegistrationNumber": "12345678901",
      "otherIdentifiers": [
        { "type": "IT_TAX_CD", "value": "12345678901" }
      ]
    }
  }
}
```

## API call examples

When making subsequent API calls in V2, use the kyckrId from the search response:

* Use the `kyckrId` value as the identifier in the URL

## Migration guide

### ⚠️ Required updates

1. Update search result processing to expect REA identifiers in the `companyNumber` field
2. Modify systems that store company identifiers
3. \[Future] Update identifier handling:
   * Use the future `otherIdentifiers` array to access standardized identifiers
   * Use the appropriate type codes (IT\_REA\_CD, IT\_VAT\_CD, IT\_TAX\_CD) to identify different identifier types

### ⚠️ Impact assessment

* This change primarily affects systems that:
  * Store Italian company identifiers
  * Rely on fiscal codes as primary identifiers
  * Use Codice Fiscale for search - this may return multiple entity matches.

## Italian province code reference

The following is a complete map of Italian province codes used in the REA number format:

| Province              | Code | Province             | Code | Province        | Code |
| --------------------- | ---- | -------------------- | ---- | --------------- | ---- |
| Agrigento             | AG   | Alessandria          | AL   | Ancona          | AN   |
| Aosta                 | AO   | Arezzo               | AR   | Ascoli Piceno   | AP   |
| Asti                  | AT   | Avellino             | AV   | Bari            | BA   |
| Barletta-Andria-Trani | BT   | Belluno              | BL   | Benevento       | BN   |
| Bergamo               | BG   | Biella               | BI   | Bologna         | BO   |
| Bolzano               | BZ   | Brescia              | BS   | Brindisi        | BR   |
| Cagliari              | CA   | Caltanissetta        | CL   | Campobasso      | CB   |
| Caserta               | CE   | Catania              | CT   | Catanzaro       | CZ   |
| Chieti                | CH   | Como                 | CO   | Cosenza         | CS   |
| Cremona               | CR   | Crotone              | KR   | Cuneo           | CN   |
| Enna                  | EN   | Fermo                | FM   | Ferrara         | FE   |
| Firenze               | FI   | Foggia               | FG   | Forlì-Cesena    | FC   |
| Frosinone             | FR   | Genova               | GE   | Gorizia         | GO   |
| Grosseto              | GR   | Imperia              | IM   | Isernia         | IS   |
| La Spezia             | SP   | L'Aquila             | AQ   | Latina          | LT   |
| Lecce                 | LE   | Lecco                | LC   | Livorno         | LI   |
| Lodi                  | LO   | Lucca                | LU   | Macerata        | MC   |
| Mantova               | MN   | Massa-Carrara        | MS   | Matera          | MT   |
| Messina               | ME   | Milano               | MI   | Modena          | MO   |
| Monza e Brianza       | MB   | Napoli               | NA   | Novara          | NO   |
| Nuoro                 | NU   | Oristano             | OR   | Padova          | PD   |
| Palermo               | PA   | Parma                | PR   | Pavia           | PV   |
| Perugia               | PG   | Pesaro e Urbino      | PU   | Pescara         | PE   |
| Piacenza              | PC   | Pisa                 | PI   | Pistoia         | PT   |
| Pordenone             | PN   | Potenza              | PZ   | Prato           | PO   |
| Ragusa                | RG   | Ravenna              | RA   | Reggio Calabria | RC   |
| Reggio Emilia         | RE   | Rieti                | RI   | Rimini          | RN   |
| Roma                  | RM   | Rovigo               | RO   | Salerno         | SA   |
| Sassari               | SS   | Savona               | SV   | Siena           | SI   |
| Siracusa              | SR   | Sondrio              | SO   | Taranto         | TA   |
| Teramo                | TE   | Terni                | TR   | Torino          | TO   |
| Trapani               | TP   | Trento               | TN   | Treviso         | TV   |
| Trieste               | TS   | Udine                | UD   | Varese          | VA   |
| Venezia               | VE   | Verbano-Cusio-Ossola | VB   | Vercelli        | VC   |
| Verona                | VR   | Vibo Valentia        | VV   | Vicenza         | VI   |
| Viterbo               | VT   | Viterbo              | VT   | Viterbo         | VT   |