Run with Postman

Imprese

This service provides REST calls to extract information on businesses and companies from simple parameters such as denomination or VAT number

Company Information

Starting from basic data of a company such as VAT number, tax code or denomination, detailed information on the company itself is extracted

This service returns basic information of a company such as company name and address

Authorizations:
path Parameters
piva_cf_or_id
required
string
Default: "<string>"
Example: 12485671007

VAT number, tax code or company ID

Responses

Response Schema: application/json
object (Base)
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://test.imprese.openapi.it/base/%7Bpiva_cf_or_id%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

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

Authorizations:
query Parameters
denominazione
string
Default: "<string>"
Example: denominazione=altravia

name of the company (you can search for parts of the name as long as they are whole words)

provincia
string
Default: "<string>"
Example: provincia=RM

the code of the region you want to search in

codice_ateco
string
Default: "<string>"
Example: codice_ateco=6201

ateco code

cciaa
string
Default: "<string>"
Example: cciaa=RM

Chamber of Commerce

rea
string
Default: "<string>"
Example: rea=1378273

rea code

fatturato_min
integer
Default: "<integer>"
Example: fatturato_min=100000

minimum revenue value

fatturato_max
integer
Default: "<integer>"
Example: fatturato_max=1000000

maximum revenue value

dipendenti_min
integer
Default: "<integer>"
Example: dipendenti_min=1

minimum value of employees

dipendenti_max
integer
Default: "<integer>"
Example: dipendenti_max=5

maximum value of employees

skip
integer
Default: "<integer>"
Example: skip=50

to set the number of records you want to skip from the result set

limit
integer [ 1 .. 100 ]
Default: "<integer>"
Example: limit=10

number of results you want to receive; if not set, the call will return a maximum of 100 results

dry_run
integer
Default: "<integer>"
Enum: 1 0
Example: dry_run=0

simulates a request by returning only the number of records found and the price

lat
number <double> [ -90 .. 90 ]
Default: "<double>"
Example: lat=13.5478

latitude

lng
number <double> [ -180 .. 180 ]
Default: "<double>"
Example: lng=42.859

longitude

radius
integer > 0
Default: "<integer>"
Example: radius=100

radius in meters

Responses

Response Schema: application/json
Array of objects (BaseElenco) [ items ]
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://test.imprese.openapi.it/advance?denominazione=altravia&provincia=RM&codice_ateco=6201&cciaa=RM&rea=1378273&fatturato_min=100000&fatturato_max=1000000&dipendenti_min=1&dipendenti_max=5&skip=50&limit=10&dry_run=0&lat=13.5478&lng=42.859&radius=100");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}