Table of Contents
- Data Sources
- Company Identifiers
- Search Capabilities
- Quirks & Gotchas
- Mappings
- Data Availability
- Example API Responses
Data Sources
Italy uses two data sources that both access the Registro Imprese (Italian Business Register), the official economic registry managed by the Italian Chambers of Commerce. For a given entity, data comes from a single primary source — the system does not merge attributes across sources. It follows a deterministic priority chain and returns data from the first source that provides complete information.Commercial companies
- InfoCamere (Registro Imprese AIWS API) — InfoCamere is the IT company for the Italian Chambers of Commerce, established in 1993 to manage the electronic Business Register (Registro Imprese telematico). This is the primary source for comprehensive company data. Data is retrieved via XML-based “blocchi” API endpoints (AMM, ALB, SOC blocks), providing the richest dataset: company name, legal form, status, identifiers, registered address, share capital, ATECO activity codes, legal representatives (with birth data), and shareholders (with ownership percentages, nominal capital, and paid-in amounts).
- OpenAPI (Registro Imprese REST API) — A commercial REST API provided by OpenAPI SpA that queries the same underlying Registro Imprese data. Used as a fallback when InfoCamere blocchi data is not available, and as the primary source for search operations and onboarding profiles. Three endpoint tiers are used: IT-search (name/parameter search), IT-advanced (company profile fallback), and IT-full (comprehensive data for onboarding, including managers, shareholders, employees, and financials).
Sole entrepreneurs
- InfoCamere Person Card API — For sole proprietorships (Impresa Individuale), a dedicated “scheda persona” (person card) endpoint retrieves data by the owner’s personal Codice Fiscale (16-character alphanumeric code). This provides the business name, address, ATECO codes, and owner information. Used as the primary source when queried with a personal Codice Fiscale.
- OpenAPI (IT-advanced) — Used as a fallback for sole proprietorship detection when InfoCamere returns no data. Also used to detect sole proprietorships queried with a VAT number and redirect the user to the correct identifier.
The system first attempts to retrieve data from InfoCamere (primary). If InfoCamere returns no data, it falls back to OpenAPI. Both sources access the same underlying Registro Imprese data, but InfoCamere provides a richer, more structured dataset (especially for shareholders and legal representatives).
Data Source Priority & Routing
For a given company query, data comes from one source only (all-or-nothing model):- InfoCamere AMM block — Fetch company data from the AMM (Amministrazione) block via XML API
- InfoCamere ALB block — If AMM fails or returns empty, try the ALB (Albo) block as fallback
- InfoCamere Person Card — For sole proprietors (16-char fiscal code), try the person card endpoint
- OpenAPI IT-advanced — If all InfoCamere sources fail, fall back to the REST API
InfoCamere blocchi pricing
Per-blocco costs (measured Feb 2025, VETTORE SRL 04046761203):| Block | Description | Cost |
|---|---|---|
| AMM | Company data (legal name, legal form, representatives, address, capital, activities) | €0.75 |
| SOC | Shareholder data (ownership percentages, nominal capital, paid-in amounts) | €1.50 |
| Full profile | AMM + SOC (typical company profile) | €2.25 |
Company Identifiers
Query Identifiers
| Identifier | Format | Example | Notes |
|---|---|---|---|
| Codice Fiscale (company) | 11 digits | 01234567890 | Universal fiscal identifier; for companies, typically identical to Partita IVA |
| Partita IVA (VAT number) | 11 digits | 01234567890 | Required for commercial activities; usually identical to Codice Fiscale for companies |
| Codice Fiscale (individual) | 16 alphanumeric | RSSMRA85M01H501Z | Personal tax code for sole proprietors; encodes name, birth date, and place |
| CCIAA + REA Code | 2 letters + 1-7 digits | TO1239673 | Provincial register identifier (CCIAA = Chamber province, REA = register number) |
Primary Identifier: The system uses Codice Fiscale as the company ID for all Italian entities. For companies (SRL, SPA, etc.), the 11-digit Codice Fiscale is typically identical to their Partita IVA. For sole proprietors, the 16-character personal Codice Fiscale must be used — they cannot be queried by their 11-digit VAT number.
Identifiers in API Response
| Identifier | Key | Always Present | Example |
|---|---|---|---|
| Partita IVA | VAT | When available | 01234567890 |
| Codice Fiscale | Codice Fiscale | Yes | 01234567890 or RSSMRA85M01H501Z |
| CCIAA | CCIAA | When available | MI |
| REA Code | REA Code | When available | 2098765 |
Search Capabilities
Search automatically detects the identifier type and routes to the appropriate endpoint:| Search Pattern | Format | Examples | Match Type | Results |
|---|---|---|---|---|
| Company Name | Text string | Barilla, Zona Web | Fuzzy match | Up to 10 results |
| CCIAA + REA | 2 letters + 1-7 digits | TO1239673, TO 1239673 | Exact match by province | 1 result |
| REA Only | 1-7 digits (not 11) | 1239673, 12345 | Cross-province + name search | Multiple results |
| Partita IVA | 11 digits | 01234567890, IT01234567890 | Exact ID match | 1 result |
| Codice Fiscale (company) | 11 digits | 03943150270 | Exact ID match | 1 result |
| Codice Fiscale (individual) | 16 alphanumeric | RSSMRA85M01H501Z | Exact ID match | 1 result |
IT prefix on identifiers is automatically stripped.
Quirks & Gotchas
| Quirk | Details |
|---|---|
| Codice Fiscale = Partita IVA for companies | For companies (SRL, SPA, etc.), the 11-digit Codice Fiscale is usually identical to the Partita IVA. For sole proprietors, they are always different. |
| Sole proprietors need personal Codice Fiscale | Sole proprietorships (Impresa Individuale) must be queried using their 16-character personal Codice Fiscale, not their 11-digit Partita IVA. Querying with Partita IVA returns a not-found error with a hint to use the correct identifier. |
| IT prefix is optional | The IT prefix on Partita IVA / Codice Fiscale is automatically stripped. Both IT01234567890 and 01234567890 work. |
| REA is province-scoped | REA numbers are unique within a province but can exist in multiple provinces. Always pair with CCIAA code for exact identification. |
| Legal rep roles are AI-enriched | The local Italian role name is always preserved verbatim. The standardized role mapping and English translation use AI enrichment. |
| ISIC and NACE are AI-inferred | All ATECO, RAE, SAE, and SIC codes are official registry data. Only ISIC and NACE are derived via AI. Check the isAIInferred flag. |
| ATECO code lengths vary | ATECO codes range from 2 to 6 digits depending on the granularity of the registered activity. There is no universal logic for code length. |
| Shareholder birth data cross-reference | InfoCamere’s SOC block does not include birth date/place for shareholders. The system cross-references by fiscal code with legal representative data to enrich shareholders with birth information where available. |
| SOC block may fail for cooperatives | The shareholder (SOC) block can return 400 errors for certain company types (e.g., cooperatives). In this case, the profile is returned without shareholder data rather than failing entirely. |
| Document delivery is asynchronous | Visura and bilancio documents are ordered from InfoCamere and then polled for availability. Estimated delivery time is 5 minutes (300 seconds). |
| Bilancio documents are historical | Financial statement documents never change once filed. They are cached permanently since they never change. |
Mappings
Company Status
Company status is determined deterministically from Italian registry status codes. No AI inference is involved.| Code | Local Status | English Translation | Standardized Status |
|---|---|---|---|
A | Attiva | Active | ACTIVE |
C | Cessata | Ceased | CLOSED |
CF | Out of business | Out of Business | CLOSED |
CS | Out of business | Out of Business | CLOSED |
I | Inactive | Inactive | UNKNOWN |
IF | In closure | In Closure | UNDER_INSOLVENCY_PROCEEDING |
IS | In closure | In Closure | UNDER_INSOLVENCY_PROCEEDING |
S | Dormant | Dormant | UNKNOWN |
Status codes come from two sources: InfoCamere provides a simple A (active) / C (ceased) classification, while OpenAPI provides more granular codes (CF, CS, I, IF, IS, S). The richer code set is used when available. Unknown codes default to
UNKNOWN status.Legal Forms
Italy has 70+ official legal form classifications managed by the Chambers of Commerce. Legal form mapping uses a deterministic code-to-description lookup for Italian names and a static dictionary for English translations. When no deterministic match is found, AI enrichment is used to translate and standardize the legal form, and to assign the ISO 20275 (ELF) code.Key Business Forms
Key Business Forms
| Code | Italian Name | English Translation | ISO 20275 |
|---|---|---|---|
SR | Societa’ a Responsabilita’ Limitata | Limited Liability Company | V9QP |
SP | Societa’ per Azioni | Joint Stock Company | 8888 |
AS | Societa’ in Accomandita Semplice | Limited Partnership | - |
SN | Societa’ in Nome Collettivo | General Partnership | - |
AA | Societa’ in Accomandita per Azioni | Limited Partnership by Shares | - |
SE | Societa’ Semplice | Simple Partnership | - |
SA | Societa’ Anonima | Anonymous Company | - |
SV | Societa’ tra Professionisti | Professional Partnership | - |
Single-Member & Simplified Forms
Single-Member & Simplified Forms
| Code | Italian Name | English Translation | ISO 20275 |
|---|---|---|---|
SU | Societa’ a Responsabilita’ Limitata con Unico Socio | Single-Member Limited Liability Company | - |
AU | Societa’ per Azioni con Socio Unico | Single-Member Joint Stock Company | - |
RS | Societa’ a Responsabilita’ Limitata Semplificata | Simplified Limited Liability Company | - |
RR | Societa’ a Responsabilita’ Limitata a Capitale Ridotto | Reduced Capital Limited Liability Company | - |
Sole Proprietorships
Sole Proprietorships
| Code | Italian Name | English Translation | ISO 20275 |
|---|---|---|---|
DI | Impresa Individuale | Sole Proprietorship | - |
PF | Persona Fisica | Natural Person | - |
IF | Impresa Familiare | Family Business | - |
Cooperatives
Cooperatives
| Code | Italian Name | English Translation | ISO 20275 |
|---|---|---|---|
SC | Societa’ Cooperativa | Cooperative Company | - |
OO | Cooperativa Sociale | Social Cooperative | - |
CL | Societa’ Cooperativa a Responsabilita Limitata | Limited Liability Cooperative | - |
CI | Societa’ Cooperativa a Responsabilita Illimitata | Unlimited Liability Cooperative | - |
PC | Piccola Societa’ Cooperativa | Small Cooperative Company | - |
PS | Piccola Societa’ Cooperativa a Responsabilita’ Limitata | Small Limited Liability Cooperative | - |
OC | Societa’ Cooperativa Consortile | Consortium Cooperative Company | - |
Consortiums & Groups
Consortiums & Groups
| Code | Italian Name | English Translation | ISO 20275 |
|---|---|---|---|
CO | Consorzio | Consortium | - |
CC | Consorzio con Attivita’ Esterna | Consortium with External Activity | - |
CS | Consorzio senza Attivita’ Esterna | Consortium without External Activity | - |
CF | Consorzio Fidi | Credit Guarantee Consortium | - |
CR | Consorzio Intercomunale | Inter-Municipal Consortium | - |
CM | Consorzio Municipale | Municipal Consortium | - |
CZ | Consorzio di cui al DLgs 267/2000 | Consortium under DLgs 267/2000 | - |
CN | Societa’ Consortile | Consortium Company | - |
SL | Societa’ Consortile a Responsabilita’ Limitata | Consortium Limited Liability Company | - |
SO | Societa’ Consortile per Azioni | Consortium Joint Stock Company | - |
OS | Societa’ Consortile Cooperativa a Responsabilita’ Limitata | Consortium Cooperative Limited Liability Company | - |
AN | Societa’ Consortile in Nome Collettivo | Consortium General Partnership | - |
AE | Societa’ Consortile in Accomandita Semplice | Consortium Limited Partnership | - |
GE | Gruppo Europeo di Interesse Economico | European Economic Interest Grouping | - |
RC | Contratto di Rete dotato di Soggettivita’ Giuridica | Network Contract with Legal Personality | - |
Associations & Non-Profits
Associations & Non-Profits
| Code | Italian Name | English Translation | ISO 20275 |
|---|---|---|---|
AC | Associazione | Association | - |
AI | Associazione Impresa | Business Association | - |
PA | Associazione in Partecipazione | Joint Venture Association | - |
FO | Fondazione | Foundation | - |
FI | Fondazione Impresa | Business Foundation | - |
SM | Societa’ di Mutuo Soccorso | Mutual Aid Society | - |
MA | Mutua Assicurazione | Mutual Insurance | - |
EM | Ente Morale | Moral Entity | - |
Public Law & Ecclesiastical Entities
Public Law & Ecclesiastical Entities
| Code | Italian Name | English Translation | ISO 20275 |
|---|---|---|---|
EP | Ente Pubblico Economico | Public Economic Entity | - |
ED | Ente Diritto Pubblico | Public Law Entity | - |
EC | Ente Pubblico Commerciale | Public Commercial Entity | - |
EN | Ente | Entity | - |
EI | Ente Impresa | Business Entity | - |
EL | Ente Sociale | Social Entity | - |
EE | Ente Ecclesiastico | Ecclesiastical Entity | - |
ER | Ente Ecclesiastico Civilmente Riconosciuto | Civilly Recognized Ecclesiastical Entity | - |
IR | Istituto Religioso | Religious Institute | - |
ES | Ente di cui alla L.R. 21-12-93 N88 | Entity under Regional Law 88/1993 | - |
AL | Azienda Speciale | Special Agency | - |
LL | Azienda Speciale di cui al DLgs 267/2000 | Special Agency under DLgs 267/2000 | - |
AZ | Azienda Speciale REA | Special Agency REA | - |
AM | Azienda Municipale | Municipal Company | - |
AP | Azienda Provinciale | Provincial Company | - |
AR | Azienda Regionale | Regional Company | - |
AT | Azienda Autonoma Statale | Autonomous State Company | - |
Financial Institutions & Foreign Entities
Financial Institutions & Foreign Entities
| Code | Italian Name | English Translation | ISO 20275 |
|---|---|---|---|
IC | Istituto di Credito | Credit Institution | - |
ID | Istituto di Credito di Diritto Pubblico | Public Law Credit Institution | - |
ST | Soggetto Estero | Foreign Entity | - |
SS | Societa’ Costituita in Base a Leggi di Altro Stato | Company Incorporated under Foreign Law | - |
SZ | Societa’ non Prevista dalla Legislazione Italiana | Company Not Provided for under Italian Law | - |
SD | Societa’ Europea | European Company (SE) | - |
SG | Societa’ Cooperativa Europea | European Cooperative Society (SCE) | - |
Other & Historical Forms
Other & Historical Forms
| Code | Italian Name | English Translation | ISO 20275 |
|---|---|---|---|
AF | Altre Forme | Other Forms | - |
SF | Societa’ di Fatto | De Facto Partnership | - |
SI | Societa’ Irregolare | Irregular Company | - |
CE | Comunione Ereditaria | Hereditary Community | - |
XX | Non Precisata | Unspecified | - |
ISO 20275 (ELF) codes are assigned via AI enrichment. The most common forms (SRL = V9QP, SPA = 8888) have well-established mappings. Less common forms may not have assigned ELF codes.
Legal Representatives
Legal representatives are extracted from InfoCamere (AMM/ALB XML blocks) and OpenAPI (IT-full endpoint withisLegalRepresentative: true). Role standardization uses AI enrichment — the local Italian role name is always preserved verbatim. Both individuals and corporate entities can hold legal representative roles.
Executive & Management Roles
Executive & Management Roles
| Italian Role | English Translation |
|---|---|
| Amministratore unico | Sole Director |
| Amministratore delegato | Managing Director / CEO |
| Amministratore | Director |
| Presidente del consiglio di amministrazione | Chairman of the Board |
| Consigliere delegato | Executive Board Member |
| Consigliere | Board Member |
| Socio amministratore | Managing Partner |
| Presidente | President / Chairman |
| Vice presidente | Vice President |
| Direttore generale | General Manager |
| Titolare | Owner |
Representative & Legal Roles
Representative & Legal Roles
| Italian Role | English Translation |
|---|---|
| Rappresentante legale | Legal Representative |
| Procuratore | Attorney / Proxy |
| Procuratore speciale | Special Attorney |
| Institore | Business Manager (Institor) |
| Liquidatore | Liquidator |
Partnership & Cooperative Roles
Partnership & Cooperative Roles
| Italian Role | English Translation |
|---|---|
| Socio accomandatario | General Partner (unlimited liability) |
| Socio accomandante | Limited Partner |
| Socio unico | Sole Shareholder |
Role mapping is AI-enriched. The local Italian role name from the registry is always preserved as
localName. The englishTranslation and standardized fields are generated by AI. Since the Italian registry uses free-text role descriptions rather than a fixed codelist, the set of possible roles is open-ended.Other Key Persons
Other key persons are extracted from the OpenAPI IT-full endpoint when theisLegalRepresentative flag is false. These are persons associated with the company who do not have statutory authority to bind the company.
| Italian Role | English Translation |
|---|---|
| Sindaco | Statutory Auditor |
| Sindaco effettivo | Effective Statutory Auditor |
| Sindaco supplente | Alternate Statutory Auditor |
| Presidente del collegio sindacale | Chairman of the Board of Auditors |
| Revisore legale | Legal Auditor |
| Revisore contabile | Accounting Auditor |
| Membro del collegio sindacale | Member of the Board of Auditors |
Other key persons are only available through the OpenAPI IT-full data source (used for onboarding profiles). InfoCamere blocchi data returns all persons in a single list without the
isLegalRepresentative distinction. Both individuals and corporate entities can appear as other key persons.Shareholders
Shareholders are extracted from both InfoCamere (SOC block) and OpenAPI (IT-full endpoint). Both individual and corporate shareholders are supported. Extraction Logic:| Source | When Used | Data Extracted |
|---|---|---|
| InfoCamere SOC block | Primary source (non-cooperative companies) | Shareholders with ownership percentages, nominal capital held, paid-in amounts, fiscal codes, addresses, country codes |
| OpenAPI IT-full | Fallback / onboarding profile | Shareholders with ownership percentages, fiscal codes |
| Person Card (sole proprietors) | Sole proprietorship queries | Owner as 100% shareholder |
| Field | Description | InfoCamere | OpenAPI |
|---|---|---|---|
sharePercentage | Ownership percentage | Yes | Yes |
nominalCapitalHeld | Nominal capital amount held (EUR) | Yes | No |
paidInAmount | Amount of capital paid in (EUR) | Yes | No |
type | INDIVIDUAL or COMPANY | Yes | Yes |
individual.identifiers | Codice Fiscale of shareholder | Yes | Yes |
company.countryCode | Country code for foreign corporate shareholders | Yes | No |
The InfoCamere SOC block does not include birth date/place for shareholders. When a shareholder is also a legal representative (common in small Italian companies), the system cross-references by fiscal code and copies birth information from the legal representative record to enrich the shareholder data.
Activity Code Mapping
Italy uses the ATECO (Attivita Economiche) classification system, maintained by ISTAT (Italian National Institute of Statistics). The ATECO 2025 classification, effective from April 1, 2025, aligns with the EU’s NACE Rev. 2.1 system and has 6 levels of classification depth. Classification pipeline:| Classification | Source | AI-Inferred | Notes |
|---|---|---|---|
| ATECO2025 | Registry (InfoCamere) | No | Latest Italian standard; primary and secondary codes |
| ATECO2022 | Registry (OpenAPI) | No | Previous Italian standard |
| RAE | Registry (OpenAPI IT-full) | No | Italian Economic Administrative Register (single code) |
| SAE | Registry (OpenAPI IT-full) | No | Italian Statistical Administrative classification (single code) |
| SIC | Registry (OpenAPI IT-full) | No | US Standard Industrial Classification (single code) |
| NACE | AI-enriched | Yes | European standard, derived from highest-priority ATECO code |
| ISIC | AI-enriched | Yes | International standard, derived from highest-priority ATECO code |
- Primary ATECO2025 code (if available)
- Primary ATECO2022 code (if ATECO2025 unavailable)
- RAE code (if no ATECO codes available)
- SAE code (if no other codes available)
ATECO code lengths vary from 2 to 6 digits depending on the granularity of the registered activity. There is no universal logic for code length. InfoCamere (primary source) typically provides ATECO2025 codes with NACE derivations. OpenAPI (fallback) provides ATECO2022 codes.
Data Availability
Data Availability Matrix
| Data Point | InfoCamere (Primary) | OpenAPI Advanced (Fallback) | OpenAPI Full (Onboarding) |
|---|---|---|---|
| Company name | Yes | Yes | Yes |
| Legal form | Yes | Yes | Yes |
| Status | Yes (A/C) | Yes (A/C) | Yes (granular codes) |
| Identifiers (VAT, CF, CCIAA, REA) | Yes | Yes | Yes |
| Registered address | Yes | Yes | Yes |
| Share capital | Yes (from SOC block) | No | Yes |
| Incorporation date | Yes | Yes | Yes |
| Registration date | Yes | Yes | Yes |
| ATECO activity codes | Yes (ATECO2025 + NACE) | Yes (ATECO2022) | Yes (ATECO) |
| Activity description | Yes | Yes | Yes |
| Legal representatives | Yes (with birth data) | No | Yes (with birth data) |
| Other key persons | No | No | Yes |
| Shareholders | Yes (with nominal/paid-in) | No | Yes (percentages only) |
| Employee count | No | No | Yes (exact or range) |
| Phone / website | No | No | Yes |
| PEC (certified email) | Yes | Yes | Yes |
Documents by Company Type
All Company Types
| Document | Type | Format | SKU | Delivery | Notes |
|---|---|---|---|---|---|
| Visura Camerale | Certified Trade Register Extract | ITA_CERTIFIED_REGISTER_EXTRACT | ~5 min | Official extract from Registro Imprese via InfoCamere | |
| Bilancio d’Esercizio | Financial Statement | ZIP | ITA_FINANCIAL_STATEMENTS | ~5 min | Annual accounts per fiscal year; ZIP contains XBRL/PDF |
| Bilancio Consolidato | Consolidated Financial Statement | ZIP | ITA_FINANCIAL_STATEMENTS | ~5 min | Consolidated group accounts per fiscal year |
Documents are ordered from InfoCamere and generated asynchronously. The Visura Camerale is cached for 24 hours; subsequent requests within this period return the cached version. Financial statements are historical documents and are cached permanently since historical filings never change. Bilancio documents are listed dynamically from the InfoCamere API per company, showing all available fiscal years.
Example API Responses
All examples use placeholder data. Query:POST /company with { "id": "<id>", "countryCode": "IT", "dataPoints": ["companyProfile"] }
Active SRL (Source: InfoCamere)
Active SRL (Source: InfoCamere)
Active SPA (Source: OpenAPI Fallback)
Active SPA (Source: OpenAPI Fallback)
Ceased Company
Ceased Company
Sole Proprietorship (Source: InfoCamere Person Card)
Sole Proprietorship (Source: InfoCamere Person Card)
Onboarding Profile (Source: OpenAPI IT-full)
Onboarding Profile (Source: OpenAPI IT-full)
Available Documents
Available Documents
Documents are returned when
"dataPoints": ["availableDocuments"] is requested.Activity Code Example (Multiple Classifications)
Activity Code Example (Multiple Classifications)
This example shows a company with multiple ATECO codes and full classification chain:In this example:
- Primary activity:
1073(Manufacture of farinaceous products) from ATECO2025 - ISIC/NACE: AI-derived from primary ATECO2025 code
- Secondary activities: Additional ATECO codes for installation services
- Single-value codes: RAE (pasta manufacturing), SAE (productive enterprises), SIC