March 2025

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

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:

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

After:

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

Lite Profile

Before:

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

After:

{
  "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:

{
  "data": {
    "identifiers": {
      "primaryRegistrationNumber": "12345678901",
      "secondaryRegistrationNumber": "MI123456"
    }
  }
}

After:

{
  "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: