Enterprises

The parameter depends on the endpoint for which the request is to be made.

For the Get /base, /advance/, /closed, /gruppoiva, /pec, /soci the parameter is one of the following:

• vat number
• tax code
• id (only for base and advance)

For the GET Advance endpoint, one or more of the following parameters may be passed:

• name or part (in this case the name must always be an integer) of the company name
• province
• ATECO code
• CCIAA
• REA
• minimum and/or maximum turnover
• minimum and/or maximum employees

For the GET /Autocomplete endpoint the parameter can be a string (also with wildcard '*') and optionally latitude, longitude and radius.

For the GET endpoint /forma_giuridica/ no parameter is needed, for Get /forma_giuridica/ it is the legal nature code.

For the GET endpoint /updates the parameters, all optional, are latitude, longitude, radius.

For the endpoint /updates/{timestamp} the mandatory one must be added to the previous endpoints: timestamp (i.e. the date from which to start the search).

The API Enterprises offers information on any type of Italian company. The dataset available in the response may depend on whether the business is registered with the Chamber of Commerce or not. For freelancers not registered with the Chamber of Commerce, we suggest using the risk endpoint anagrafica to obtain information such as location, name, Ateco code and description, tax domicile and personal information.

The response is returned in real time for all endpoints.

The parameters for making a request to the two endpoints are the same:

• VAT number
• tax code
• id

The difference is in the data present in the response.

The GET Base response contains the following data:

• tax code
• name
• VAT number
• toponym
• street
• street number
• full address
• municipality
• hamlet
• province
• activity status
• update date
• postal code
• addressee code
• company id
• longitude
• latitude
• chamber of commerce registration date

In the GET Advance response, in addition to all the data in the base, there are

• REA
• PEC
• Legal Nature Code
• ATECO Code and Description
• Activity Start Date
• Closing Date Balance Sheet, Turnover, Profit (with history up to 5 years)
• Employees
• Share Capital
• VAT Group
• Company status at the Tax Agency
• Shareholders (Name / Name, Tax code / percentage share)

The Get /advance endpoint allows you to find companies based on parameters that can be turnover number, employees, ATECO code, coordinates and radius.

One or more companies can be included in the response based on the parameters used in the request. For each individual company, the following data are available

• tax code
• name
• VAT number
• toponym
• street
• street number
• full address
• municipality
• hamlet
• province
• activity status
• update date
• postal code
• farm id
• longitude
• latitude
• code legal nature
• date of registration with the Chamber of Commerce

Get /advance{piva_cf_or_id} instead requires one of the following values as a parameter:

• VAT number
• tax code
• company id

The response will only concern one company and will return the following data:

• tax code
• company name
• VAT number
• toponym
• street
• street number
• full address
• municipality
• hamlet
• province
• activity status
• update date
• postal code
• addressee code
• company id
• longitude
• latitude
• chamber of commerce registration date
• REA
• PEC
• Legal Nature Code
• ATECO Code and Description
• Start date
• Closing Date Balance Sheet, Turnover, Profit (with history up to 5 years)
• Employees
• Share Capital
• VAT Group
• Company status at the Tax Agency
• Shareholders (Name / Name, Tax code / percentage share)

GET Advance allows you to obtain a list of companies with a range of information. A maximum limit of 100 results is set by default for each individual request.
If more than 100 results are available, you can use the SKIP parameter to set the number of records you want to skip from the result set.

Dry run, skip and limit are optional parameters that can be inserted in a request to GET Advance.

Dry Run allows you to simulate a request by returning only the number of records found and the price. In practice, it indicates how many companies are compatible with the parameters used in the request.

Skip on the other hand allows you to set the number of records you wish to skip from the result set.

Limit indicates the maximum number of results you wish to obtain in the response. Please note that by default the response includes a maximum of 100 results.

There is no limit to the radius given as a parameter, but please note that the maximum number of results per single request is 100.

In the Get Advance answer, the registered office of the company is available.

Membership information is available via the dedicated Get /soci endpoint or is also available in the response dataset for the Get Advance/{piva_or_cf} endpoint.
The response is returned in real time and includes name or designation, tax code and percentage share.

The shareholders in the list are those who have a share of 10% or more (the same information can also be obtained from the deposited balance sheet, if it has been deposited in the last 4 years).

For more up-to-date and enriched data, you can also use the GET /stakeholders endpoint of the Company API, where you can obtain more information on the company roles, the shareholders and the company in general.

They are two different pieces of information and come from different official sources.

The activity status field indicates the status of the company according to the Italian Chamber of Commerce. The values that may be present in the answer are:

• Active
• Registered
• Inactive
• Suspended
• Enrolled
• Ceased

The field ceased instead indicates the status of the company with the Internal Revenue Service. In this case the available values are:

• True
• False

No, the Enterprise API does not have daily rate limits.

The cost of individual requests depends on the endpoint and ranges from 0.001€ up to 0.10€. All prices for individual requests (base prices) are available in the Pricing section, where it is also indicated whether subscriptions are available and the percentage savings.

You can activate your subscription in the subscription section by indicating the subscription duration (month/year), selecting the number of requests and the start date. Once payment is complete, requests will be available immediately (you can also decide to start a subscription at a later date). For payment by bank transfer, requests will be available once the amount has been credited.

Yes, there are 30 requests per month for Get pec, base, closed and soci endpoints. For more information, please consult the Prices section.

In the Usage section, you can monitor your free and subscription or top-up requests. They are available both in graphical mode (period month and year) and with a textual summary.

All data in the answers of the Enterprise API come from official and certified sources and public databases via TULPS licence, e.g. Chamber of Commerce, INPS (National Social Insurance Agency), Revenue Agency.

Yes, further information can be accessed via the Company API, where over 400 individual company, employee and marketing data are available.

Enterprises and Company both offer information on Italian companies.

Enterprises allows a quick check on a company and offers the essential dataset for trouble-free invoicing. It presents information such as activity status (CCIAA), status in the Internal Revenue Service, Turnover, Profit, Employees, etc. It also provides a number of endpoints for obtaining specific data, such as recipient code, PEC, VAT group (=codice destinatario, PEC, gruppo IVA).

With Company, on the other hand, you have access to a much larger dataset, up to 400 data points, to carry out a detailed analysis of the company, its stakeholders and to access all contacts and information to plan marketing activities.

The update depends on the type of data and the endpoint.

The data in the Cessate (=Ceased) and SdI endpoint are updated daily. New and ceased companies are updated within 24 hours. Data such as fatturato, utile e PEC (=turnover, profit and PEC/CEM) are updated on average weekly and may have a delay of up to 1 month. Dipendenti (=Employees) data is updated quarterly.

They are two different pieces of information and come from different official sources.

The Stato Attività (=Activity Status) field indicates the status of the company according to the Italian Chamber of Commerce. The values that may be present in the answer are:

• Attiva (=Active)
• Registrata (=Registered)
• Inattiva (=Inactive)
• Sospesa (=Suspended)
• In Iscrizione (=Enrolled)
• Cessata (=Ceased

The field Cessata (=Ceased) instead indicates the status of the company with the Internal Revenue Service. In this case the available values are:

• True
• False

The obligation to identify oneself through the identity document of the individual or company requesting the service is only required for some services subject to the TULPS and its related license (Article 6 of the TULPS license).

For some services, the TULPS regulations require the identification of the service user. In the case of companies, it is therefore required to upload an identity document (driver's license, passport, identity card) belonging to either the legal representative or a person with signing powers or a delegate for the provision and use of the specific service (e.g., IT manager or administrative office).