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
- 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
- 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):- Official register data is used for verification-mode company, legal representative, other key person, shareholder, establishment, and subsidiary datapoints.
- Fast-source data is used for prefill where available.
- Sole proprietors must be queried with their personal Codice Fiscale.
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.
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.Legal Entity Identifier (LEI)
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 ataxId 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:
- 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.sourceisvies. - 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.sourceset toagenzia_entrate.
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:
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, soactiveOnly=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.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
Single-Member & Simplified Forms
Single-Member & Simplified Forms
Sole Proprietorships
Sole Proprietorships
Cooperatives
Cooperatives
Consortiums & Groups
Consortiums & Groups
Associations & Non-Profits
Associations & Non-Profits
Public Law & Ecclesiastical Entities
Public Law & Ecclesiastical Entities
Financial Institutions & Foreign Entities
Financial Institutions & Foreign Entities
Other & Historical Forms
Other & Historical Forms
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.Legal Representatives
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.
Executive & Management Roles
Executive & Management Roles
Representative & Legal Roles
Representative & Legal Roles
Partnership & Cooperative Roles
Partnership & Cooperative 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.
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:
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 inmode: "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.
Active SRL (Source: Registro Imprese)
Active SRL (Source: Registro Imprese)
Active SPA (Verification fallback source)
Active SPA (Verification fallback source)
Ceased Company
Ceased Company
Sole Proprietorship (Source: Registro Imprese)
Sole Proprietorship (Source: Registro Imprese)
legalRepresentatives. Requesting shareholders for a sole proprietorship returns an explicit not-applicable response, with no charge.Prefill Profile (Source: fast profile source)
Prefill Profile (Source: fast profile source)
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.Available Documents
Available Documents
Documents are returned when
"dataPoints": ["availableDocuments"] is requested.Activity Code Example (Verification)
Activity Code Example (Verification)
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:
107300from 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
isAIInferredisfalse