Italian company identifier changed from codice fiscale to REA

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]\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	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	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:

Name Search: Search by company name
REA: Search using the REA (IT_REA_CD) format
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

Update search result processing to expect REA identifiers in the companyNumber field
Modify systems that store company identifiers
[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

​Overview

​Italy company identifiers

​Key changes

​Technical details

​Search methods

​Response field changes

​V2 API

​Example responses

​Search response

​Lite Profile

​Enhanced Profile

​API call examples

​Migration guide

​⚠️ Required updates

​⚠️ Impact assessment

​Italian province code reference

Overview

Italy company identifiers

Key changes

Technical details

Search methods

Response field changes

V2 API

Example responses

Search response

Lite Profile

Enhanced Profile

API call examples

Migration guide

⚠️ Required updates

⚠️ Impact assessment

Italian province code reference