Unternehmen

  1. Home
  2. API Library
  3. Unternehmen
Die API wurde durch die neuen, in Company verfügbaren Endpunkte ersetzt

Um Zugang zu allen Stammdaten, Tätigkeitsinformationen, Aktionären und wirtschaftlichen Daten eines italienischen Unternehmens zu erhalten, entdecken Sie die neuen Dienste Company

Deprecated starting from 2025-12-31

All das Wissen, das Sie benötigen

Hier finden Sie einige Ratschläge, die Sie berücksichtigen sollten, um sich dieser API zu nähern. Wenn Sie möchten, bieten wir Code-Beispiele, OAS3-Dokumentation, die Möglichkeit, die API live über Swagger UI auszuprobieren oder die gesamte Sammlung in Postman zu importieren. Wir bieten auch eine Sandbox-Umgebung an, in der Sie kostenlos mit allen Arten von Anfragen experimentieren können.

Nützliche Tipps für den Einstieg Unternehmen

Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.

Verwenden Sie das Online-Tool oder generieren Sie es über die API. Legen Sie das Ablaufdatum, einen nützlichen Namen fest und fügen Sie jetzt eine Vielzahl von Scopes hinzu, um die möglichen Aktionen Ihres Tokens zu begrenzen.
Lesen Sie mehr über die OAuth-API Meine Tokens verwalten


Kennen Sie bereits die Umsatzsteuer-Identifikationsnummer oder den TAX-Code?

Holen Sie sich Unternehmensinformationen mit einer einzigen Anfrage über einen der verfügbaren Endpunkte:
/base, /pec, /soci, /closed und /gruppoiva. Jeder dieser Endpunkte liefert spezifische Informationen, so dass Sie nur für das bezahlen, was Sie benötigen.
Wenn Sie alle Informationen auf einmal benötigen, können Sie /advance.

Auf der Suche nach einem Unternehmen?

Wir bieten zwei Möglichkeiten, ein Unternehmen zu finden. Wenn Sie eine schnelle Textsuche über Millionen von Unternehmen durchführen möchten, empfehlen wir /autocomplete. Damit können Sie Ihre Ergebnisse durch Georeferenzierung der Anfrage verfeinern.
Wenn Sie bessere Filteroptionen benötigen, stellen wir /advance. vor. Damit können Sie filtern nach: Firmenname, Provinz, ateco code, cciaa code, rea code, Jahresumsatz, Mitarbeiter, Breitengrad, Längengrad und Radius. Jedes Ergebnis enthält alle /base-Daten, es sei denn, Sie verwenden die Option "dry_run", die nur die Anzahl der Datensätze kostenlos zurückgibt.
API docs by Redocly

Imprese (1.0.0)

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

Dieser Dienst bietet REST-Aufrufe zur Extraktion von Informationen über Unternehmen und Gesellschaften anhand einfacher Parameter wie Bezeichnung oder Mehrwertsteuernummer.

Unter diesem Link finden Sie eine Liste von Unternehmen, mit denen Sie den Dienst in einer Sandbox-Umgebung testen können.

Zum ersten Mal hier? Erzeugen Sie ein neues Zugangstoken

Company Information

Ausgehend von grundlegenden Daten eines Unternehmens wie Mehrwertsteuernummer, Steuernummer oder Bezeichnung werden detaillierte Informationen über das Unternehmen selbst extrahiert

Grundlegende Daten

Dieser Punkt gibt grundlegende Informationen über ein Unternehmen zurück, z. B. den Firmennamen und die Adresse.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Mehrwertsteuernummer, Steuernummer oder Unternehmens-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://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
}

Erweiterte Suche und Daten

Mit diesem Endpunkt können wir eine Liste von Unternehmen erstellen, die bestimmten unten beschriebenen Parametern entsprechen. Der Aufruf liefert maximal 100 Ergebnisse, auch wenn Sie eine höhere Grenze festlegen.

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

name des Unternehmens (Sie können nach Teilen des Namens suchen, solange es sich um ganze Wörter handelt)

provincia
string
Example: provincia=RM

den Code der Region, in der Sie suchen möchten

codice_ateco
string
Example: codice_ateco=6201

ateco-Code

cciaa
string
Example: cciaa=RM

Handelskammer

rea
string
Example: rea=1378273

rea-Code

fatturato_min
integer
Example: fatturato_min=100000

mindesteinnahmewert

fatturato_max
integer
Example: fatturato_max=1000000

maximaler Ertragswert

dipendenti_min
integer
Example: dipendenti_min=1

mindestwert der Beschäftigten

dipendenti_max
integer
Example: dipendenti_max=5

höchstwert der Mitarbeiter

skip
integer
Example: skip=50

um die Anzahl der Datensätze festzulegen, die Sie aus der Ergebnismenge auslassen möchten

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

anzahl der Ergebnisse, die Sie erhalten möchten; wenn nicht angegeben, liefert der Aufruf maximal 100 Ergebnisse

dry_run
integer
Enum: 1 0
Example: dry_run=0

simuliert eine Anfrage und gibt nur die Anzahl der gefundenen Datensätze und den Preis zurück

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

breitengrad

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

längengrad

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

radius in Metern

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
}

Erweiterte Suche und Daten

Dieser Endpunkt ruft erweiterte Informationen über ein Unternehmen ab, wie z. B. ateco-Code, Bilanz und pec.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Mehrwertsteuernummer, Steuernummer oder 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
}

Beendigung der Tätigkeit

Einfacher Endpunkt, um in Echtzeit zu verstehen, ob eine Umsatzsteuer-Identifikationsnummer laut Finanzamt erloschen ist oder nicht.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Mehrwertsteuernummer, Steuernummer oder 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
}

Zugehörigkeit zu einer MwSt-Gruppe

Anhand dieses Endpunkts können Sie feststellen, ob ein Unternehmen zu einer MwSt-Gruppe gehört und ob das Steuerkennzeichen mit der als Eingabe verwendeten MwSt-Nummer übereinstimmt.

Authorizations:
bearerAuth
path Parameters
piva_or_cf
required
string
Example: 12485671007

Umsatzsteuer-Identifikationsnummer oder Steuernummer

query Parameters
cf
string
Example: cf=12345678910

wenn ein Steuerkennzeichen angegeben wird, liefert dieser Dienst zusätzliche Informationen über die Beziehung zwischen dem MwSt.-Kennzeichen und dem Steuerkennzeichen

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
}

Zertifizierte E-Mail

Ausgehend von einer Umsatzsteuer-Identifikationsnummer wird der Pec des Unternehmens extrahiert.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Mehrwertsteuernummer, Steuernummer oder 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
{}

Suche nach Namen

Dieser Endpunkt führt eine Suche in der Liste aller verfügbaren Unternehmen mit der angegebenen Abfrage durch.

Authorizations:
bearerAuth
path Parameters
query
required
string
Examples:
  • altravia* - Beginnt mit
  • *altravia - Endet mit
  • *altravia* - Enthält

Eine Suchabfrage; '*' kann als Platzhalter verwendet werden, um nach Zeichenfolgen zu suchen, die mit der angegebenen Abfrage beginnen, sie enthalten oder auf sie enden.

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

breitengrad

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

längengrad

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

radius in Metern

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
}

Alle Rechtsformen

Mit diesem Endpunkt können Sie alle registrierten Rechtsformen einsehen.

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
}

Besondere Rechtsform

Mit diesem Endpunkt können Sie den Wert des als Parameter übergebenen gesetzlichen Codes sehen.

Authorizations:
bearerAuth
path Parameters
codice_natura_giuridica
required
string
Example: SP

gesetzbuch

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
}

Eine Liste der aktualisierten Unternehmen

Dieser Endpunkt gibt die Liste aller Unternehmen zurück (nur die ID).

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

breitengrad

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

längengrad

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

radius in Metern

skip
integer
Example: skip=50

sie können eine Anzahl von Datensätzen festlegen, die Sie überspringen möchten, oder die Kennung eines Unternehmens, mit dem Sie beginnen möchten

limit
integer
Example: limit=5000

wird verwendet, um die maximale Anzahl der erforderlichen Ergebnisse festzulegen

dry_run
integer
Enum: 1 0
Example: dry_run=0

simuliert eine Anfrage und gibt nur die Anzahl der gefundenen Datensätze zurück

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
}

Eine Liste der aktualisierten Unternehmen

Dieser Endpunkt gibt die Liste aller Unternehmen zurück, die nach Überschreiten des Zeitschwellenwerts über den Zeitstempel (nur die ID) aktualisiert wurden.

Authorizations:
bearerAuth
path Parameters
timestamp
required
integer
Example: 1645021792

zeitstempel

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

breitengrad

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

längengrad

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

radius in Metern

skip
integer
Example: skip=50

sie können eine Anzahl von Datensätzen festlegen, die Sie überspringen möchten, oder die Kennung eines Unternehmens, mit dem Sie beginnen möchten

limit
integer
Example: limit=5000

wird verwendet, um die maximale Anzahl der erforderlichen Ergebnisse festzulegen

dry_run
integer
Enum: 1 0
Example: dry_run=0

simuliert eine Anfrage und gibt nur die Anzahl der gefundenen Datensätze zurück

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
}

Aktionäre eines Unternehmens

Dieser Endpunkt gibt die Liste der Aktionäre eines Unternehmens zurück, die einen Anteil von mehr als 10 Prozent an dem Unternehmen haben.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Mehrwertsteuernummer, Steuernummer oder Unternehmens-ID

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
}

SDI-Code eines Unternehmens

Dieser Endpunkt liefert den in Echtzeit aktualisierten SDI-Code des Unternehmens.

Authorizations:
bearerAuth
path Parameters
piva_cf_or_id
required
string
Example: 12485671007

Mehrwertsteuernummer, Steuernummer oder Unternehmens-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/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