Skip to main content

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.

​
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 CodeFormatLengthPatternDescriptionExampleNotes
IT_REA_CD2 letters + digits2 + variable[A-Z]\d+Trade register number (REA). Consists of province code followed by registration numberNA0091712Province code (e.g. NA=Naples) followed by unique registration number. Each Chamber of Commerce (CCIAA) maintains its own register
IT_VAT_CDIT + 11 digits13IT\dEuropean VAT numberIT12345678912Italian VAT numbers always start with IT prefix followed by 11 digits
IT_TAX_CD16 characters16For companies: \dTax identification code (Codice Fiscale)For company: 12345678901For 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: 
{
  "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:
ProvinceCodeProvinceCodeProvinceCode
AgrigentoAGAlessandriaALAnconaAN
AostaAOArezzoARAscoli PicenoAP
AstiATAvellinoAVBariBA
Barletta-Andria-TraniBTBellunoBLBeneventoBN
BergamoBGBiellaBIBolognaBO
BolzanoBZBresciaBSBrindisiBR
CagliariCACaltanissettaCLCampobassoCB
CasertaCECataniaCTCatanzaroCZ
ChietiCHComoCOCosenzaCS
CremonaCRCrotoneKRCuneoCN
EnnaENFermoFMFerraraFE
FirenzeFIFoggiaFGForlì-CesenaFC
FrosinoneFRGenovaGEGoriziaGO
GrossetoGRImperiaIMIserniaIS
La SpeziaSPL’AquilaAQLatinaLT
LecceLELeccoLCLivornoLI
LodiLOLuccaLUMacerataMC
MantovaMNMassa-CarraraMSMateraMT
MessinaMEMilanoMIModenaMO
Monza e BrianzaMBNapoliNANovaraNO
NuoroNUOristanoORPadovaPD
PalermoPAParmaPRPaviaPV
PerugiaPGPesaro e UrbinoPUPescaraPE
PiacenzaPCPisaPIPistoiaPT
PordenonePNPotenzaPZPratoPO
RagusaRGRavennaRAReggio CalabriaRC
Reggio EmiliaRERietiRIRiminiRN
RomaRMRovigoROSalernoSA
SassariSSSavonaSVSienaSI
SiracusaSRSondrioSOTarantoTA
TeramoTETerniTRTorinoTO
TrapaniTPTrentoTNTrevisoTV
TriesteTSUdineUDVareseVA
VeneziaVEVerbano-Cusio-OssolaVBVercelliVC
VeronaVRVibo ValentiaVVVicenzaVI
ViterboVTViterboVTViterboVT