Company

  1. Home
  2. API Library
  3. Company
All the data about companies in a single API and in just a few seconds

With Company, you can access accurate, official, and always up-to-date data on companies on a global, European, and national scale

All the knowledge you need

Here you can find some advice to consider to approach this API. If you prefer, we provide code samples, OAS3 documentation, the ability to try the API live via the Swagger UI or import the entire collection into Postman. We also offer a Sandbox environment where you can experiment with all kinds of requests completely free of charge.

Useful tips to start with Company

Get the token in the appropriate section before you start.

Use the the online tool or generate it via API. Set the expire date, a usefull name and now add a bunch of scopes to limit the possible actions your token can do.
Read more on oauth API Manage my tokens

Get detailed company information from VAT number or tax code

Get company information with a single request using one of the available endpoints:
Each endpoint returns specific information, so you only pay for what you need.
If you want all the information at once, you can use  /IT-full.

Use the powerful search and data extraction tool

Here are some of the features of /IT-search:

  • Search by many combinable fields:
    • Geospatial: latitude - longitude - radius
    • Textual: companyName (also with wildcard)
    • Autocomplete: companyName (realtime and great for graphical interfaces)
    • Province
    • Municipality: Cadastral code (Belfiore)
    • Ateco code
    • Chamber of Commerce/REA
    • Turnover (minimum and maximum)
    • Employees (minimum and maximum)
    • SDI Code (Recipient Code declared for electronic invoicing)
    • Legal form (free list here: /IT-legalforms)
    • Employees (minimum and maximum)
    • Owners (tax code)
    • Business status (ACTIVE, CEASED, REGISTERED, INACTIVE, SUSPENDED, IN_REGISTRATION)
    • Pec
    • Creation date (to get only new companies)
    • Update date (to get only recently modified companies: new balance sheet submitted or change in name or address)
  • Get the number of available records for free using the "dryRun" option
  • Enrich the search by populating the results with the dataset you prefer in a single synchronous call using the "dataEnrichment" option
  • Pagination support with "skip" and "limit" options

Use these companies to test the Sandbox

At this address you will find a list of companies to use in the sandbox and still receive a complete dataset.https://docs.openapi.it/company-sandbox-examples.html
API docs by Redocly

Company (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

This service provides REST calls to extract information on businesses and companies from VAT or TAX code.

At this link you can find a list of companies that allow you to try the service in a sandbox environment.

First time here? Generate a new access token

Company

Extraction of company information starting from VAT or TAX code

Anti Money Laundering

Call that allows you to extract data from a company for anti-money laundering purposes

Authorizations:
bearerAuth
path Parameters
vatCode_or_taxCode
required
string
Example: 12485671007

vat code or tax code

Responses

Response Schema: application/json
Array of objects (Aml)
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://company.openapi.com/IT-aml/%7BvatCode_or_taxCode%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
}

Marketing

Call that allows you to extract data from a company for a marketing function

Authorizations:
bearerAuth
path Parameters
vatCode_or_taxCode
required
string
Example: 12485671007

vat code or tax code

Responses

Response Schema: application/json
Array of objects (Marketing)
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://company.openapi.com/IT-marketing/%7BvatCode_or_taxCode%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
}

Stakeholders

Call that allows you to extract data from a company to see all its stakeholders

Authorizations:
bearerAuth
path Parameters
vatCode_or_taxCode
required
string
Example: 12485671007

vat code or tax code

Responses

Response Schema: application/json
Array of objects (Stakeholders)
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://company.openapi.com/IT-stakeholders/%7BvatCode_or_taxCode%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
}

All the data

Call that allows you to extract all the data of a company

Authorizations:
bearerAuth
path Parameters
vatCode_or_taxCode
required
string
Example: 12485671007

vat code or tax code

Responses

Response Schema: application/json
Array of objects (Full)
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://company.openapi.com/IT-full/%7BvatCode_or_taxCode%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
}
Web Service Revision: 2.0.0