Search italian companies by advanced search criteria
get_company_IT_searchSearch Italian companies by name, location, ATECO, size, or status to find VAT numbers and retrieve paginated enriched data; use dryRun to count matches.
Instructions
Returns a list of Italian companies based on the search criteria.
Use this tool if you do not know the VAT number of a company.
Use it with dryRun=1 and no limit parameter to get only the count
of available results for the matching criteria.
Use it to extract enriched data, paginated with skip up to 1000
records, such as name, address, PEC, start data, or advanced data.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_company_IT_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude for geographical search (optional). | |
| pec | No | PEC email address of the company (optional). | |
| long | No | Longitude for geographical search (optional). | |
| skip | No | The number of records to skip for pagination (optional). | |
| cciaa | No | Chamber of Commerce code (optional). | |
| limit | No | The max number of results to return. To get only the total count, skip this parameter and set ``dryRun`` to 1. | |
| dryRun | No | Returns only the number of records found and the price. | |
| radius | No | Radius in meters for geographical search (optional). | |
| endDate | No | Filter by the end date of the company (optional). | |
| reaCode | No | REA code (optional). | |
| sdiCode | No | SDI code (optional). | |
| townCode | No | The cadastral code for the town (optional). | |
| atecoCode | No | ATECO code for the company (optional). | |
| startDate | No | Filter by the start date of the company (optional). | |
| companyName | No | The name or part of it of an Italian company (optional). | |
| maxTurnover | No | Maximum turnover value (optional). | |
| minTurnover | No | Minimum turnover value (optional). | |
| autocomplete | No | Search for strings that begin with the specified query (optional). | |
| maxEmployees | No | Maximum number of employees (optional). | |
| minEmployees | No | Minimum number of employees (optional). | |
| provinceCode | No | The 2 letter province code to restrict the results. | |
| legalFormCode | No | Filter by company legal form. Use ``get_company_IT_legal_forms_list`` to inspect the available codes. | |
| activityStatus | No | Status in the Chamber of Commerce. Allowed values are ``ATTIVA``, ``CESSATA``, ``REGISTRATA``, ``INATTIVA``, ``SOSPESA``, and ``IN_ISCRIZIONE``. | |
| dataEnrichment | No | Additional enrichment options. Allowed values are ``start``, ``advanced``, ``pec``, ``address``, ``shareholders``, and ``name``. | name |
| creationTimestamp | No | Filter by creation unix timestamp (optional). | |
| shareHolderTaxCode | No | Tax code of a company member (optional). | |
| lastUpdateTimestamp | No | Filter by last update unix timestamp (optional). |