Entreprises

  1. Home
  2. Bibliothèque d'API
  3. Entreprises
L'API a été remplacée par les nouveaux points d'accès disponibles dans Company

Pour accéder à l'ensemble des données de base, des informations commerciales, des actionnaires et des données économiques d'une entreprise italienne, découvrez les nouveaux services aux entreprises.

Deprecated starting from 2025-12-31

Toutes les connaissances dont vous avez besoin

Vous trouverez ici quelques conseils à prendre en compte pour aborder cette API. Si vous préférez, nous fournissons des exemples de code, la documentation OAS3, la possibilité d'essayer l'API en direct via Swagger UI ou d'importer l'intégralité de la collection dans Postman. Nous proposons également un environnement Sandbox où vous pouvez expérimenter toutes sortes de requêtes de manière totalement gratuite.

Conseils utiles pour commencer Entreprises

Obtenir le Token dans la section appropriée avant de commencer.

Utilisez l'outil en ligne ou générez-le via l'API. Définissez la date d'expiration, un nom utile et ajoutez maintenant un ensemble d'étendues pour limiter les actions possibles que votre jeton peut effectuer.
En savoir plus sur l'API oauth Gérer mes jetons


Vous connaissez déjà le numéro de TVA ou le code fiscal?

Obtenez des informations sur l'entreprise en une seule demande en utilisant l'un des points de terminaison disponibles:
/base, /pec, /soci, /closed et /gruppoiva. Chacun d'entre eux renvoie des informations spécifiques, de sorte que vous ne payez que pour ce dont vous avez besoin.
Si vous avez besoin de toutes les informations en une seule fois, vous pouvez utiliser  /advance.

Vous recherchez une entreprise?

Nous exposons deux façons de trouver une entreprise. Si vous avez besoin d'un moyen de faire une recherche de texte rapide parmi des millions d'entreprises, nous vous suggérons /autocomplete. Vous pouvez ainsi affiner vos résultats en géoréférençant la requête.
Si vous avez besoin de meilleures options de filtrage, nous vous proposons /advance. Il vous permet de filtrer pour : le nom de l'entreprise, la province, le code ateco, le code cciaa, le code rea, le revenu annuel, les employés, la latitude, la longitude et le rayon. Chaque résultat contient toutes les données de /base, sauf si vous utilisez l'option "dry_run" qui ne renvoie que le nombre d'enregistrements gratuitement.
API docs by Redocly

Imprese (1.0.0)

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

Ce service propose des appels REST pour extraire des informations sur les entreprises et les sociétés à partir de paramètres simples tels que la dénomination ou le numéro de TVA.

Sur ce lien, vous trouverez une liste d'entreprises qui vous permettent d'essayer le service dans un environnement "bac à sable".

C'est la première fois que vous venez ici ? Générer un nouveau jeton d'accès

Company Information

À partir des données de base d'une entreprise, telles que le numéro de TVA, le code fiscal ou la dénomination, des informations détaillées sur l'entreprise elle-même sont extraites

Données de base

Ce point de contact renvoie les informations de base d'une entreprise, telles que son nom et son adresse.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Numéro de TVA, code fiscal ou numéro d'identification de l'entreprise

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://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
}

Recherche avancée et données

Ce point d'accès permet de dresser une liste d'entreprises correspondant à certains paramètres décrits ci-dessous. L'appel renvoie un maximum de 100 résultats même si vous avez fixé une limite plus élevée.

Authorizations:
bearerAuth
query Parameters
denominazione
string
Example: denominazione=altravia

le nom de l'entreprise (vous pouvez rechercher des parties du nom à condition qu'il s'agisse de mots entiers)

provincia
string
Example: provincia=RM

le code de la région dans laquelle vous souhaitez effectuer une recherche

codice_ateco
string
Example: codice_ateco=6201

code ateco

cciaa
string
Example: cciaa=RM

Chambre de commerce

rea
string
Example: rea=1378273

code rea

fatturato_min
integer
Example: fatturato_min=100000

valeur minimale des recettes

fatturato_max
integer
Example: fatturato_max=1000000

valeur maximale des recettes

dipendenti_min
integer
Example: dipendenti_min=1

valeur minimale des salariés

dipendenti_max
integer
Example: dipendenti_max=5

valeur maximale des salariés

skip
integer
Example: skip=50

pour définir le nombre d'enregistrements à ignorer dans le jeu de résultats

limit
integer [ 1 .. 100 ]
Example: limit=10

nombre de résultats que vous souhaitez recevoir ; s'il n'est pas défini, l'appel renverra un maximum de 100 résultats

dry_run
integer
Enum: 1 0
Example: dry_run=0

simule une requête en ne renvoyant que le nombre d'enregistrements trouvés et le prix

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

latitude

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

longitude

radius
integer ( 0 .. 3000 ]
Example: radius=100

rayon en mètres

Responses

Response Schema: application/json
Array of objects (BaseElenco)
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://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
}

Recherche avancée et données

Ce point d'accès permet d'obtenir des informations avancées sur une entreprise, telles que le code Ateco, le bilan et le pec.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Numéro de TVA, code fiscal ou ID

Responses

Response Schema: application/json
object (Advance)
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://imprese.openapi.it/advance/%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
}

Cessation d'activité

Point final simple pour comprendre en temps réel si un numéro de TVA a cessé ou non selon le bureau des impôts.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Numéro de TVA, code fiscal ou ID

Responses

Response Schema: application/json
object
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://imprese.openapi.it/closed/%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
}

Appartenance à un groupe TVA

Ce point final permet de savoir si une entreprise fait partie d'un groupe TVA et si le code fiscal est cohérent avec le numéro de TVA pris en entrée.

Authorizations:
bearerAuth
path Parameters
piva_or_cf
required
string
Example: 12485671007

Numéro de TVA ou code fiscal

query Parameters
cf
string
Example: cf=12345678910

si un code fiscal est indiqué, ce service renvoie des informations supplémentaires sur la relation entre le groupe de TVA et le code fiscal

Responses

Response Schema: application/json
object
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://imprese.openapi.it/gruppoiva/%7Bpiva_or_cf%7D?cf=12345678910");

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
Example
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Courrier électronique certifié

A partir d'un numéro de TVA, il extrait le pec de l'entreprise.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Numéro de TVA, code fiscal ou ID

Responses

Response Schema: application/json
object
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://imprese.openapi.it/pec/%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
{}

Recherche par nom

Ce point d'accès effectue une recherche dans la liste de toutes les entreprises disponibles avec la requête donnée.

Authorizations:
bearerAuth
path Parameters
query
required
string
Examples:
  • altravia* - Commence par
  • *altravia - Se termine par
  • *altravia* - Contient

Une requête de recherche ; "*" peut être utilisé comme joker pour rechercher les chaînes qui commencent, contiennent ou se terminent par la requête donnée.

query Parameters
lat
number <double> [ -90 .. 90 ]
Example: lat=13.5478

latitude

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

longitude

radius
integer ( 0 .. 3000 ]
Example: radius=100

rayon en mètres

Responses

Response Schema: application/json
Array of objects (Autocomplete)
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://imprese.openapi.it/autocomplete/%7Bquery%7D?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
}

Toutes les formes juridiques

Ce point d'accès vous permet de voir tous les formulaires juridiques enregistrés.

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects (FormaGiuridica)
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://imprese.openapi.it/forma_giuridica");

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
}

Forme juridique spécifique

Ce point d'accès vous permet de voir la valeur du code juridique transmis en tant que paramètre.

Authorizations:
bearerAuth
path Parameters
codice_natura_giuridica
required
string
Example: SP

code juridique

Responses

Response Schema: application/json
object (FormaGiuridica)
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://imprese.openapi.it/forma_giuridica/%7Bcodice_natura_giuridica%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
}

Une liste d'entreprises mises à jour

Ce point d'accès renvoie la liste de toutes les entreprises (uniquement l'identifiant).

Authorizations:
bearerAuth
query Parameters
lat
number <double> [ -90 .. 90 ]
Example: lat=13.5478

latitude

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

longitude

radius
integer ( 0 .. 3000 ]
Example: radius=100

rayon en mètres

skip
integer
Example: skip=50

vous pouvez définir un nombre d'enregistrements à ignorer ou l'identifiant d'une entreprise à partir de laquelle vous souhaitez commencer

limit
integer
Example: limit=5000

permet de définir le nombre maximum de résultats requis

dry_run
integer
Enum: 1 0
Example: dry_run=0

simule une requête en ne renvoyant que le nombre d'enregistrements trouvés

Responses

Response Schema: application/json
Array of objects
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://imprese.openapi.it/updates?lat=13.5478&lng=42.859&radius=100&skip=50&limit=5000&dry_run=0");

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
}

Une liste d'entreprises mises à jour

Ce point d'accès renvoie la liste de toutes les entreprises qui ont fait l'objet d'une mise à jour après le délai fixé par l'intermédiaire de l'horodatage (uniquement l'identifiant).

Authorizations:
bearerAuth
path Parameters
timestamp
required
integer
Example: 1645021792

horodatage

query Parameters
lat
number <double> [ -90 .. 90 ]
Example: lat=13.5478

latitude

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

longitude

radius
integer ( 0 .. 3000 ]
Example: radius=100

rayon en mètres

skip
integer
Example: skip=50

vous pouvez définir un nombre d'enregistrements à ignorer ou l'identifiant d'une entreprise à partir de laquelle vous souhaitez commencer

limit
integer
Example: limit=5000

permet de définir le nombre maximum de résultats requis

dry_run
integer
Enum: 1 0
Example: dry_run=0

simule une requête en ne renvoyant que le nombre d'enregistrements trouvés

Responses

Response Schema: application/json
Array of objects
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://imprese.openapi.it/updates/%7Btimestamp%7D?lat=13.5478&lng=42.859&radius=100&skip=50&limit=5000&dry_run=0");

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
}

Actionnaires d'une société

Ce point de terminaison renvoie la liste des actionnaires d'une entreprise qui détiennent une part de l'entreprise supérieure à 10 %.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Numéro de TVA, code fiscal ou numéro d'identification de l'entreprise

Responses

Response Schema: application/json
Array of objects (Soci)
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://imprese.openapi.it/soci/%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
}

Code SDI d'une entreprise

Ce point d'accès renvoie le code SDI de l'entreprise mis à jour en temps réel.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Numéro de TVA, code fiscal ou numéro d'identification de l'entreprise

Responses

Response Schema: application/json
object
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://imprese.openapi.it/codice_destinatario/%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
}
Web Service Revision: 2.0.0