Skip to main content
This guide is outdated and will be removed on 1 November 2026. The up-to-date Italy reference is on the Italy country page.

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.

Italy coverage, pricing, and sources

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

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, other key persons, shareholders, subsidiaries, establishments, and financial statements when available.
  • Fast profile source — Used for search operations and prefill profiles when a faster response is required. See Verification vs prefill mode 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 prefill may use different source paths. Use the authoritative flag in dataStatus to decide whether to trigger a verification follow-up after prefill.

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, other key person, shareholder, establishment, and subsidiary datapoints.
  2. Fast-source data is used for prefill where available.
  3. Sole proprietors must be queried with their personal Codice Fiscale.
Use Italy coverage, pricing, and sources for the live mode and data block catalog.

Company Identifiers

Query Identifiers

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 instead: it resolves them to the Codice Fiscale to use here.

Identifiers in API Response

The EUID is derived from the company’s Registro Imprese number (Codice Fiscale), preserving leading zeros. It is included for supported domestic limited-company forms, including SRL, SpA and SRLS. It is omitted for sole traders, partnerships, cooperatives, foreign-law entities and unknown legal forms. EUID search is not supported.
The same keys are used for the identifiers of legal representatives, shareholders and subsidiaries. The capitalised spellings Codice Fiscale, CCIAA and REA Code were retired on 2026-09-01.
GLEIF is the supplementary data source for this identifier. company.identifiers.lei is optional. It is returned when the Codice Fiscale (codiceFiscale) matches exactly one LEI through a GLEIF registration or validation reference. The Legal Entity Identifier has 20 uppercase alphanumeric characters, ending in two check digits. Coverage varies by entity. An absent lei does not prove that the company has no LEI. Lapsed, retired or merged LEIs may be returned; annulled LEIs are excluded.

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.
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:
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 a fast third-party profile source. 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.

Active companies only

Search can return companies that are no longer active, but their status is not known at search time, so activeOnly=true has no effect. Check company.status on the company profile. Search results do not carry the company status, so ceased companies can appear; check the status on the company profile.

Quirks & Gotchas

Mappings

Company Status

Company status is determined deterministically from Italian registry status codes. No AI inference is involved.
The prefill path reports only active (A) or ceased (C). Unknown codes default to UNKNOWN status.
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.
ISO 20275 (ELF) codes are matched against GLEIF’s ELF code list for Italy (for example SRL = OV32, SPA = P418). Forms marked - have no dedicated Italian entry in that list.
When the register publishes signing powers for a returned representative’s appointment, signingPowers.localText preserves the original Italian text. Simple unconditional declarations populate representationMode.mode with sole or joint. For an explicit two-signature declaration, minimumSignatories is 2, including the representative. Powers that depend on transaction type, amount, named co-signers or other conditions remain in signingPowers.localText without a single representation mode. An absent mode means the signing arrangement has not been classified; it does not mean the person has no authority. For those texts, signingPowers.englishTranslation carries an English translation and signingAuthority a model-derived reading: a verdict (sole, sole_within_limits, joint or unclear) and one rules[] entry per power with its English scope, mode, optional amountLimit and coSigners, and the verbatim sourceExcerpt it was read from. Treat signingAuthority as an analyst’s summary to be checked against the excerpts, not as a register statement: derivedFrom is always ai, confidence drops to low when an excerpt could not be matched to the text, and unclear is returned rather than a guess when the text only refers to another instrument. Missing text means no powers text was retrieved for that appointment. A role title alone does not establish signing authority. These fields enrich the returned representatives and do not guarantee a complete list of all authorized signatories. Legal representatives are extracted from the Registro Imprese and are available in verification mode only. Known office codes use the published role catalogue for fixed English translations and standardized values; unfamiliar labels may require enrichment. The local Italian role name is preserved verbatim. Both individuals and corporate entities can hold legal representative roles.
The register publishes official office codes, alongside Italian labels that can vary by grammatical gender. Known codes use fixed translations and standardized values. The original label remains in localName. Office names identify appointments; the register’s representation information and the powers filed for that appointment establish authority.

Other Key Persons

otherKeyPersons is available in verification mode for filed office holders whose appointment has no established representation grant, including non-signing board members and auditors present in the register response. Registered representatives, and appointments with supported signing powers, appear under legalRepresentatives. Ownership alone does not create either an officer appointment or signing authority. A person may hold several distinct appointments, with different roles and powers. An office title does not imply sole or joint signing authority. Prefill returns company data only.

Shareholders

Shareholders are extracted from the register’s shareholder filing in the Registro Imprese, in verification mode only. Both individual and corporate shareholders are supported. Extraction Logic: Ownership Fields:
The register’s shareholder filing 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.
When the register has no shareholder filing for the company (for example, some cooperatives), shareholders is an empty list. When the filing is too large to be issued online, the datapoint fails with a no-document response. Both outcomes are refunded.

Subsidiaries

Subsidiaries are the inverse of shareholders: companies in which the queried company holds equity. For Italy they are extracted from the register’s filing of current participations in other companies (“Partecipazioni in altre societa’”). Fields populated: Only current participations in companies that have not been cancelled are returned. Historical participations and transfers are not surfaced, and endDate is not set. Sole proprietorships return an empty list. See Subsidiaries 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:
Available classifications in API responses: Main activity: the Registro Imprese declares each company’s prevailing activity (attivita prevalente) and publishes a single ATECO code for it. That ATECO code carries isMainActivity: true, and the NACE and ISIC codes derived from it inherit the flag.
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. AI inference is used only when no NACE code is available, which is the case on the prefill path.

Data Availability

Data Availability Matrix

Share capital in verification mode

The Italian register does not publish share capital on the company record itself. It files it with the shareholder list, which is a separate, separately priced record. That has one visible consequence in mode: "verification": Why we do not simply fetch it. Share capital is filed with the shareholder list, which is a separately priced record, so we do not buy that record just to populate one field. We do not substitute a non-authoritative source for it either: in verification mode every field we return comes from the register itself, and share capital is no exception. When the shareholder record has been retrieved, capital comes along with it at no extra charge. If you always need capital, request shareholders alongside company. You get the ownership breakdown and the capital figure together, for the price of the two blocks.
In mode: "prefill" share capital is not returned. Prefill returns only the company datapoint (name, legal form, status, identifiers, registered address, main ATECO code, incorporation and registration dates).

Documents by Company Type

Chamber of commerce documents (Visura Camerale, Visura Storica, Fascicolo Storico, Statuto) are listed only for entities registered in the Registro Imprese. An entity with no REA registration, or whose registration is still pending, has none listed.
Documents are ordered from the register 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 per company from the register, showing all available fiscal years.

Example API Responses

All examples use placeholder data. Query: POST /v2/company with { "id": "<id>", "countryCode": "IT", "dataPoints": ["company", "legalRepresentatives"] } Note that this request returns no company.capital, because the register files share capital with the shareholder list. Add "shareholders" to dataPoints to get it. See Share capital in verification mode.
When the register cannot return the company and the fast profile source is used as a fallback, legal representatives are not available and the activity code is returned under ATECO.
The owner is returned under legalRepresentatives. Requesting shareholders for a sole proprietorship returns an explicit not-applicable response, with no charge.
Query: POST /v2/company with { "id": "<id>", "countryCode": "IT", "mode": "prefill", "dataPoints": ["company"] }. Prefill returns only company: no share capital, officers, shareholders, employees, phones or website.
Documents are returned when "dataPoints": ["availableDocuments"] is requested.
In verification mode the register publishes the ATECO 2025 code of the prevailing activity together with its NACE code, and ISIC is mapped from NACE:
In this example:
  • Main activity: 107300 from ATECO_2025, as declared to the register
  • NACE: published by the register (NACE Rev. 2.1), not inferred
  • ISIC: mapped from the NACE code through the official correspondence, so isAIInferred is false