Logo
Openapi.it Public API Documentation

{{baseUrl}}/IT-search

GET {{baseUrl}}/IT-search?dryRun=<integer>&dataEnrichment=<string>&lat=<double>&long=<double>&radius=<integer>&companyName=<string>&autocomplete=<string>&province=<string>&townCode=<string>&atecoCode=<string>&cciaa=<string>&reaCode=<string>&minTurnover=<integer>&maxTurnover=<integer>&minEmployees=<integer>&maxEmployees=<integer>&sdiCode=<string>&legalFormCode=<string>&shareHolderTaxCode=<string>&activityStatus=<string>&pec=<string>&creationTimestamp=<integer>&lastUpdateTimestamp=<integer>&skip=<integer>&limit=<integer>

With this endpoint we can draw up a list of companies that correspond to certain parameters described below. The call returns a maximum of 1000 results even if you set a higher limit.

 

Body PARAM

Key Datatype Required Description 
dryRun
string simulates a request by returning only the number of records found and the price
dataEnrichment
string with this parameter you can decide how to enrich the output data; if it is not set the call will return only the ids
lat
string latitude
long
string longitude
radius
string radius in meters
companyName
string A search query; you can enter the company name (you can search for parts of the name as long as they are whole words) or alternatively '*' can be used as a wildcard to search for strings that start, contain or end with the given query. This search works with at least 3 characters.
autocomplete
string is used to search for strings that begin with the specified query
province
string the province code for which you want to carry out the search
townCode
string the cadastral code (also known as national code or Belfiore code) for which you want to carry out the search
atecoCode
string ateco code
cciaa
string Chamber of Commerce
reaCode
string rea code
minTurnover
string minimum turnover value
maxTurnover
string maximum turnover value
minEmployees
string minimum value of employees
maxEmployees
string maximum value of employees
sdiCode
string sdi code
legalFormCode
string legal form code
shareHolderTaxCode
string tax code of a company member
activityStatus
string status of the company in the chamber of commerce
pec
string company pec
creationTimestamp
string all companies created after the value
lastUpdateTimestamp
string all companies whose last update is after the value
skip
string to set the number of records you want to skip from the result set
limit
string number of results you want to receive; if not set, the call will return a maximum of 1000 results



HEADERS

Key Datatype Required Description 
Accept
string




RESPONSES

status OK

{ "data": [ { "id": "60d1bfc731177b0a092cdfc1" }, { "id": "45d1bfc788174b9u092cdtr5" } ], "success": true, "message": "", "error": null }



Curl
curl -X GET 'baseUrl/IT-search?dryRun=<integer>&dataEnrichment=<string>&lat=<double>&long=<double>&radius=<integer>&companyName=<string>&autocomplete=<string>&province=<string>&townCode=<string>&atecoCode=<string>&cciaa=<string>&reaCode=<string>&minTurnover=<integer>&maxTurnover=<integer>&minEmployees=<integer>&maxEmployees=<integer>&sdiCode=<string>&legalFormCode=<string>&shareHolderTaxCode=<string>&activityStatus=<string>&pec=<string>&creationTimestamp=<integer>&lastUpdateTimestamp=<integer>&skip=<integer>&limit=<integer>?dryRun=<integer>&dataEnrichment=<string>&lat=<double>&long=<double>&radius=<integer>&companyName=<string>&autocomplete=<string>&province=<string>&townCode=<string>&atecoCode=<string>&cciaa=<string>&reaCode=<string>&minTurnover=<integer>&maxTurnover=<integer>&minEmployees=<integer>&maxEmployees=<integer>&sdiCode=<string>&legalFormCode=<string>&shareHolderTaxCode=<string>&activityStatus=<string>&pec=<string>&creationTimestamp=<integer>&lastUpdateTimestamp=<integer>&skip=<integer>&limit=<integer>' -H 'Accept: application/json'

ENDPOINTS