> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Italy
> Country-specific identifiers, data sources, and implementation details
## Start here
This guide contains public integration notes for Italy. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
## Table of Contents
* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Data Availability](#data-availability)
* [Example API Responses](#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
* **Registro Imprese** -- The official economic register managed by the Italian Chambers of Commerce. This is the primary source for comprehensive company data: company name, legal form, status, identifiers, registered address, share capital, ATECO activity codes, legal representatives, shareholders, subsidiaries, employees, and financial information when available.
* **Fast profile source** -- Used for search operations and onboarding profiles when a faster response is required. See [Verification vs onboarding mode](/essentials/modes) for how to decide whether the fast response is sufficient for your use case.
### Sole entrepreneurs
* **Sole proprietor records** -- For sole proprietorships (*Impresa Individuale*), query using the owner's personal Codice Fiscale. The response contains business name, address, ATECO codes, and owner information when available.
Verification and onboarding may use different source paths. Use the `authoritative` flag in `dataStatus` to decide whether to trigger a verification follow-up after onboarding.
### Data Source Priority & Routing
For a given company query, data comes from **one source only** (all-or-nothing model):
1. Official register data is used for verification-mode company, legal representative, shareholder, establishment, and subsidiary datapoints.
2. Fast-source data is used for onboarding where available.
3. Sole proprietors must be queried with their personal Codice Fiscale.
Use [Italy coverage, pricing, and sources](https://topograph.co/pricing/it) for the live mode and data block catalog.
## Company Identifiers
### Query Identifiers
| Identifier | Format | Example | Notes |
| ------------------------------- | ---------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------- |
| **Codice Fiscale (company)** | 11 digits, last is a control digit | `00484960588` | Universal fiscal identifier; for companies, typically identical to Partita IVA |
| **Partita IVA (VAT number)** | 11 digits | `00484960588` | 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). Accepted by `/v2/search` only |
**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.
**`/v2/company` accepts the Codice Fiscale only.** The `id` must be either an
11-digit Codice Fiscale with a valid control digit (`00484960588`, optionally
written `IT00484960588`), or a 16-character personal Codice Fiscale for a sole
proprietor. Whitespace, dots and hyphens around an 11-digit number are accepted
and stripped, and the value is stored and echoed back in its bare, uppercase
form.
Anything else is rejected immediately with `400 invalid_request`, before any
register lookup, and is not billed. That includes a REA or CCIAA + REA code
(`RM-1734032`), a sole proprietor's Partita IVA, and an 11-digit number whose
control digit does not check out. Pass these to
[`/v2/search`](/essentials/search) instead: it resolves them to the Codice
Fiscale to use here.
### 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` |
## VAT (Partita IVA) Validation
For verification-mode company lookups, the response includes a `taxId` block: the Partita IVA plus a `verification` object that records how the number was checked and by which authority.
The Partita IVA is taken from the official register (for sole proprietors, whose Partita IVA differs from their Codice Fiscale, it is resolved automatically), then validated in two steps:
1. **VIES (EU).** The number is checked against the EU VAT Information Exchange System. If it is registered for intra-EU trade, VIES returns a consultation number that is legal proof of the check, and `verification.source` is `vies`.
2. **Agenzia delle Entrate (domestic).** Most Italian VAT numbers are not enabled for intra-EU trade, so VIES reports them as not valid even when they are perfectly active in Italy. When VIES does not confirm a number, it is checked against the Italian Revenue Agency (Agenzia delle Entrate), the authoritative source for domestic VAT status. A number confirmed there has `verification.source` set to `agenzia_entrate`.
If neither source confirms the number, `verification.status` is `unverified`. A company being active in the business register is never treated as a substitute for validating its VAT number.
| Field | Description |
| --------------------------------------- | ----------------------------------------------------------------- |
| `taxId.value` | The 11-digit Partita IVA (without the `IT` prefix) |
| `taxId.verification.status` | `verified` or `unverified` |
| `taxId.verification.source` | `vies` or `agenzia_entrate`: which authority confirmed the number |
| `taxId.verification.consultationNumber` | VIES legal-proof reference, present only when `source` is `vies` |
| `taxId.verification.verifiedName` | Name held by the validating authority for that number |
A `vies` result is the strongest proof for intra-EU transactions because it carries a consultation number. An `agenzia_entrate` result confirms the number is active for domestic purposes but has no intra-EU consultation number.
## 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 | Exact match returned first (matchType: id); other results may follow |
| **REA Only** | 1-7 digits (not 11) | `1239673`, `12345` | Cross-province + name search | Multiple results |
| **Partita IVA** | 11 digits | `01234567890`, `IT01234567890` | Exact ID match | Exact match returned first (matchType: id); other results may follow |
| **Codice Fiscale (company)** | 11 digits | `03943150270` | Exact ID match | Exact match returned first (matchType: id); other results may follow |
| **Codice Fiscale (individual)** | 16 alphanumeric | `RSSMRA85M01H501Z` | Exact ID match | Exact match returned first (matchType: id); other results may follow |
REA numbers are unique within a province but can exist in multiple provinces. Searching by REA only (without CCIAA) performs **both** a cross-province REA search and a company name search simultaneously, then combines and deduplicates the results.
Search is powered by the OpenAPI IT-search and IT-name endpoints. Name searches use fuzzy matching with up to 10 results. ID searches (Codice Fiscale, Partita IVA) return exact matches. The `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 `IT00484960588` and `00484960588` work, and both are stored under the same bare id. The prefix is only removed when what remains is an 11-digit number, so a personal Codice Fiscale that happens to start `IT` is left intact. |
| **A REA code is not a company id** | `/v2/company` rejects a REA or CCIAA + REA code with `400 invalid_request` rather than searching for it. Resolve it through `/v2/search` first. |
| **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 deduplicated 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.
| 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 | - |
| 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 | - |
| Code | Italian Name | English Translation | ISO 20275 |
| ---- | ------------------- | ------------------- | --------- |
| `DI` | Impresa Individuale | Sole Proprietorship | - |
| `PF` | Persona Fisica | Natural Person | - |
| `IF` | Impresa Familiare | Family Business | - |
| 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 | - |
| 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 | - |
| 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 | - |
| 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 | - |
| 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) | - |
| 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 with `isLegalRepresentative: 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.
| 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 |
| Italian Role | English Translation |
| --------------------- | --------------------------- |
| Rappresentante legale | Legal Representative |
| Procuratore | Attorney / Proxy |
| Procuratore speciale | Special Attorney |
| Institore | Business Manager (Institor) |
| Liquidatore | Liquidator |
| 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 the `isLegalRepresentative` 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 |
**Ownership Fields:**
| 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.
The SOC block can fail with a 400 error for certain company types (e.g., cooperatives). In this case, the company profile is returned without shareholder data rather than failing the entire request.
### Subsidiaries
Subsidiaries are the inverse of shareholders: companies in which the queried company holds equity. For Italy they are extracted from the InfoCamere PAS block ("Storia delle partecipazioni in altre societa'").
**Fields populated:**
| Field | Description |
| -------------------- | --------------------------------------------------------------- |
| `company.legalName` | Subsidiary's legal name |
| `company.id` | Subsidiary's Codice Fiscale |
| `sharePercentage` | Direct equity stake (0–100) |
| `numberOfShares` | Share or quota count held |
| `nominalCapitalHeld` | Total nominal value held (EUR) |
| `acquisitionDate` | Earliest date the participation was recorded |
| `endDate` | Set when the subsidiary has been cancelled or the holding ended |
The PAS block is skipped for sole proprietorships. Historical transfers are not surfaced in v1; only currently-held participations.
See [Subsidiaries](/essentials/subsidiaries-extraction) for the universal contract.
### 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:**
```
ATECO (Italian) → NACE (European, AI-inferred) → ISIC (International, AI-inferred)
```
**Available classifications in API responses:**
| 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 |
**ISIC/NACE Generation Priority:**
1. Primary ATECO2025 code (if available)
2. Primary ATECO2022 code (if ATECO2025 unavailable)
3. RAE code (if no ATECO codes available)
4. 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 | Catalog item | Delivery | Notes |
| ------------------------ | -------------------------------- | ------ | -------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Visura Camerale** | Certified Trade Register Extract | PDF | `ITA_CERTIFIED_REGISTER_EXTRACT` | \~5 min | Official Italian-language extract from the Registro Imprese. Includes the corporate object (oggetto sociale), board powers (poteri di firma), ATECO classification, per-branch activity matrix, employee distribution, statutory clauses, and the list of historical filings available for the company. |
| **Statuto** | Articles of Association | PDF | `ITA_ARTICLE_OF_ASSOCIATION` | \~5 min | The company's constitutional document as filed at the chamber of commerce, including any amending protocols. |
| **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 deduplicated for 24 hours; subsequent requests within this period return the deduplicated version. Financial statements are historical documents and are deduplicated 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 /v2/company` with `{ "id": "", "countryCode": "IT", "dataPoints": ["company", "legalRepresentatives"] }`
```json theme={null}
{
"company": {
"id": "01234567890",
"countryCode": "IT",
"identifiers": {
"VAT": "01234567890",
"Codice Fiscale": "01234567890",
"CCIAA": "MI",
"REA Code": "2098765"
},
"legalName": "EXAMPLE TECH SRL",
"incorporationDate": "2015-03-10",
"registrationDate": "2015-03-15",
"status": {
"localName": "attiva",
"active": true,
"statusDetails": { "status": "ACTIVE" }
},
"legalForm": {
"localName": "SOCIETA' A RESPONSABILITA' LIMITATA",
"englishTranslation": "Limited Liability Company",
"standardized": "Limited Liability Company",
"iso20275Code": "V9QP"
},
"capital": {
"amount": 50000,
"currency": "EUR"
},
"activities": {
"ATECO2025": [
{ "code": "620100", "description": "Computer programming activities", "isAIInferred": false }
],
"NACE": [
{ "code": "62.01", "description": "Computer programming activities", "isAIInferred": true }
],
"ISIC": [
{ "code": "6201", "description": "Computer programming activities", "isAIInferred": true }
]
},
"legalAddress": {
"addressLine1": "Via Roma 42",
"city": "Milano",
"postalCode": "20121",
"region": "MI",
"countryCode": "IT"
}
},
"legalRepresentatives": [
{
"type": "individual",
"role": {
"localName": "Amministratore unico",
"englishTranslation": "Sole Director",
"standardized": "Director"
},
"individual": {
"name": { "fullName": "Marco Rossi", "firstName": "Marco", "lastName": "Rossi" },
"birthDate": { "year": 1980, "month": 5, "day": 15 },
"birthAddress": { "city": "Milano", "region": "MI", "countryCode": "IT" },
"identifiers": { "Codice Fiscale": "RSSMRC80E15F205X" }
}
}
],
"shareholders": [
{
"type": "individual",
"sharePercentage": 60,
"nominalCapitalHeld": { "amount": 30000, "currency": "EUR", "formatted": "30000 EUR" },
"paidInAmount": { "amount": 30000, "currency": "EUR", "formatted": "30000 EUR" },
"individual": {
"name": { "fullName": "Marco Rossi" },
"identifiers": { "Codice Fiscale": "RSSMRC80E15F205X" },
"birthDate": { "year": 1980, "month": 5, "day": 15 },
"birthAddress": { "city": "Milano", "region": "MI", "countryCode": "IT" }
}
},
{
"type": "individual",
"sharePercentage": 40,
"nominalCapitalHeld": { "amount": 20000, "currency": "EUR", "formatted": "20000 EUR" },
"paidInAmount": { "amount": 20000, "currency": "EUR", "formatted": "20000 EUR" },
"individual": {
"name": { "fullName": "Giulia Bianchi" },
"identifiers": { "Codice Fiscale": "BNCGLI85A41H501Y" }
}
}
]
}
```
```json theme={null}
{
"company": {
"id": "09876543210",
"countryCode": "IT",
"identifiers": {
"VAT": "09876543210",
"Codice Fiscale": "09876543210",
"CCIAA": "RM",
"REA Code": "1503238"
},
"legalName": "GRANDE INDUSTRIA SPA",
"incorporationDate": "2000-01-20",
"registrationDate": "2000-02-01",
"status": {
"localName": "attiva",
"active": true,
"statusDetails": { "status": "ACTIVE" }
},
"legalForm": {
"localName": "SOCIETA' PER AZIONI",
"englishTranslation": "Joint Stock Company",
"standardized": "Corporation",
"iso20275Code": "8888"
},
"activities": {
"ATECO": [
{ "code": "461900", "description": "Agents involved in the sale of a variety of goods", "isAIInferred": false }
],
"ISIC": [
{ "code": "4610", "description": "Wholesale on a fee or contract basis", "isAIInferred": true }
],
"NACE": [
{ "code": "46.19", "description": "Agents involved in the sale of a variety of goods", "isAIInferred": true }
]
},
"legalAddress": {
"addressLine1": "Via del Corso 10",
"city": "Roma",
"postalCode": "00186",
"region": "RM",
"countryCode": "IT"
}
},
"legalRepresentatives": [],
"shareholders": []
}
```
When OpenAPI is the fallback source, legal representatives and shareholders are **not available**. Use InfoCamere (primary) for the most complete data.
```json theme={null}
{
"company": {
"id": "05678901234",
"countryCode": "IT",
"identifiers": {
"VAT": "05678901234",
"Codice Fiscale": "05678901234",
"CCIAA": "TO",
"REA Code": "876543"
},
"legalName": "VECCHIA DITTA SNC DI BIANCHI E VERDI",
"incorporationDate": "1995-06-15",
"registrationDate": "1995-07-01",
"status": {
"localName": "cessata",
"active": false,
"statusDetails": { "status": "CLOSED" }
},
"legalForm": {
"localName": "SOCIETA' IN NOME COLLETTIVO",
"englishTranslation": "General Partnership",
"standardized": "General Partnership"
},
"activities": {
"ATECO2025": [
{ "code": "471100", "description": "Retail sale in non-specialised stores", "isAIInferred": false }
]
},
"legalAddress": {
"addressLine1": "Corso Vittorio Emanuele 88",
"city": "Torino",
"postalCode": "10121",
"region": "TO",
"countryCode": "IT"
}
},
"legalRepresentatives": [
{
"type": "individual",
"role": {
"localName": "Socio amministratore",
"englishTranslation": "Managing Partner",
"standardized": "Partner"
},
"individual": {
"name": { "fullName": "Luigi Bianchi", "firstName": "Luigi", "lastName": "Bianchi" },
"identifiers": { "Codice Fiscale": "BNCLGU70A01L219K" }
}
}
],
"shareholders": []
}
```
```json theme={null}
{
"company": {
"id": "RSSMRA85M01H501Z",
"countryCode": "IT",
"identifiers": {
"Codice Fiscale": "RSSMRA85M01H501Z",
"VAT": "04567890123",
"CCIAA": "RM",
"REA Code": "1234567"
},
"legalName": "ROSSI MARIO CONSULENZE",
"incorporationDate": "2010-09-01",
"registrationDate": "2010-09-05",
"status": {
"localName": "attiva",
"active": true,
"statusDetails": { "status": "ACTIVE" }
},
"legalForm": {
"localName": "IMPRESA INDIVIDUALE",
"englishTranslation": "Sole Proprietorship",
"standardized": "Sole Proprietorship"
},
"activities": {
"ATECO2025": [
{ "code": "702200", "description": "Business and other management consultancy activities", "isAIInferred": false }
],
"NACE": [
{ "code": "70.22", "description": "Business and other management consultancy activities", "isAIInferred": true }
]
},
"legalAddress": {
"addressLine1": "Via Appia Nuova 200",
"city": "Roma",
"postalCode": "00183",
"region": "RM",
"countryCode": "IT"
}
},
"legalRepresentatives": [
{
"type": "individual",
"role": {
"localName": "TITOLARE",
"englishTranslation": "Owner",
"standardized": "Owner"
},
"individual": {
"name": { "fullName": "Mario Rossi", "firstName": "Mario", "lastName": "Rossi" },
"identifiers": { "Codice Fiscale": "RSSMRA85M01H501Z" }
}
}
],
"shareholders": [
{
"type": "individual",
"sharePercentage": 100,
"individual": {
"name": { "fullName": "Mario Rossi", "firstName": "Mario", "lastName": "Rossi" },
"identifiers": { "Codice Fiscale": "RSSMRA85M01H501Z" }
}
}
]
}
```
```json theme={null}
{
"company": {
"id": "01234567890",
"countryCode": "IT",
"identifiers": {
"VAT": "01234567890",
"Codice Fiscale": "01234567890",
"CCIAA": "MI",
"REA Code": "2098765"
},
"legalName": "EXAMPLE TECH SRL",
"incorporationDate": "2015-03-10",
"registrationDate": "2015-03-15",
"status": {
"localName": "Enable",
"active": true,
"statusDetails": { "status": "ACTIVE" }
},
"legalForm": {
"localName": "SOCIETA' A RESPONSABILITA' LIMITATA",
"englishTranslation": "Limited Liability Company",
"standardized": "Limited Liability Company",
"iso20275Code": "V9QP"
},
"capital": { "amount": 50000, "currency": "EUR" },
"employeeCount": { "exact": 25 },
"phones": ["+39 02 1234567"],
"website": "https://www.example-tech.it",
"activities": {
"ATECO": [
{ "code": "62.01", "description": "Computer programming activities", "isAIInferred": false }
],
"ISIC": [
{ "code": "6201", "description": "Computer programming activities", "isAIInferred": true }
],
"NACE": [
{ "code": "62.01", "description": "Computer programming activities", "isAIInferred": true }
]
},
"legalAddress": {
"addressLine1": "Via Roma 42",
"city": "Milano",
"postalCode": "20121",
"region": "MI",
"countryCode": "IT"
}
},
"legalRepresentatives": [
{
"type": "individual",
"role": {
"localName": "AMMINISTRATORE UNICO",
"englishTranslation": "Sole Director",
"standardized": "Director"
},
"individual": {
"name": { "fullName": "Marco Rossi", "firstName": "Marco", "lastName": "Rossi" },
"birthDate": { "year": 1980, "month": 5, "day": 15 },
"identifiers": { "Codice Fiscale": "RSSMRC80E15F205X" }
}
}
],
"shareholders": [
{
"type": "individual",
"sharePercentage": 60,
"individual": {
"name": { "fullName": "Marco Rossi", "firstName": "Marco", "lastName": "Rossi" },
"identifiers": { "Codice Fiscale": "RSSMRC80E15F205X" }
}
},
{
"type": "individual",
"sharePercentage": 40,
"individual": {
"name": { "fullName": "Giulia Bianchi", "firstName": "Giulia", "lastName": "Bianchi" },
"identifiers": { "Codice Fiscale": "BNCGLI85A41H501Y" }
}
}
],
"otherKeyPersons": [
{
"type": "individual",
"role": {
"localName": "SINDACO EFFETTIVO",
"standardized": "Other"
},
"individual": {
"name": { "fullName": "Anna Verdi", "firstName": "Anna", "lastName": "Verdi" },
"identifiers": { "Codice Fiscale": "VRDNNA75D50F205L" }
}
}
]
}
```
Documents are returned when `"dataPoints": ["availableDocuments"]` is requested.
```json theme={null}
{
"documents": [
{
"name": "Visura Camerale",
"description": "Certified trade register extract from Italian Chamber of Commerce",
"type": "certified_trade_register_extract",
"format": "pdf",
"estimatedDeliverySeconds": 300
},
{
"name": "Bilancio d'Esercizio 2023",
"description": "Financial Statement for the year ending December 31, 2023",
"type": "financial_statement",
"format": "zip",
"estimatedDeliverySeconds": 300,
"date": "2023-12-31",
"period": {
"startDate": { "year": 2023, "month": 1, "day": 1 },
"endDate": { "year": 2023, "month": 12, "day": 31 }
}
},
{
"name": "Bilancio d'Esercizio 2022",
"description": "Financial Statement for the year ending December 31, 2022",
"type": "financial_statement",
"format": "zip",
"estimatedDeliverySeconds": 300,
"date": "2022-12-31",
"period": {
"startDate": { "year": 2022, "month": 1, "day": 1 },
"endDate": { "year": 2022, "month": 12, "day": 31 }
}
},
{
"name": "Bilancio Consolidato 2023",
"description": "Consolidated Financial Statement for the year ending December 31, 2023",
"type": "financial_statement",
"format": "zip",
"estimatedDeliverySeconds": 300,
"date": "2023-12-31",
"period": {
"startDate": { "year": 2023, "month": 1, "day": 1 },
"endDate": { "year": 2023, "month": 12, "day": 31 }
}
}
]
}
```
This example shows a company with multiple ATECO codes and full classification chain:
```json theme={null}
{
"activities": {
"ATECO2025": [
{ "code": "1073", "description": "Manufacture of farinaceous products", "isAIInferred": false },
{ "code": "432101", "description": "Installation of lighting and photovoltaic systems", "isAIInferred": false },
{ "code": "432203", "description": "Installation of fire sprinkler systems", "isAIInferred": false }
],
"ATECO2022": [
{ "code": "1073", "description": "Manufacture of farinaceous products", "isAIInferred": false },
{ "code": "432101", "description": "Installation of lighting and photovoltaic systems", "isAIInferred": false }
],
"RAE": [
{ "code": "417", "description": "PASTE ALIMENTARI", "isAIInferred": false }
],
"SAE": [
{ "code": "430", "description": "Imprese produttive", "isAIInferred": false }
],
"SIC": [
{ "code": "2098", "description": "Macaroni, spaghetti & other noodle manufacturers", "isAIInferred": false }
],
"ISIC": [
{ "code": "1074", "description": "Manufacture of macaroni, noodles, couscous and similar farinaceous products", "isAIInferred": true }
],
"NACE": [
{ "code": "10.74", "description": "Manufacture of macaroni, noodles, couscous and similar farinaceous products", "isAIInferred": true }
]
}
}
```
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