Quickstart

Il tuo primo profilo aziendale in cinque minuti.

Ti servono un account e un terminale. Alla fine avrai recuperato con una richiesta di esempio il profilo aziendale di Hetzner Online GmbH e saprai cosa contiene la risposta.

Copia la tua chiave API

Crea un account gratuito e conferma il tuo indirizzo email. Ricevi 150 crediti iniziali, validi 30 giorni.

La tua prima chiave API ti aspetta già in Account › Chiavi API. Copiala e trattala come una password.

Ogni richiesta invia la chiave nell’header x-api-key. Negli esempi LA_TUA_CHIAVE_API ne fa le veci.

Se l’API risponde con 401, la chiave manca o non è stata copiata per intero. Con 403 il tuo indirizzo email non è ancora confermato. Il link di conferma lo trovi nella tua casella di posta.

Recupera un profilo aziendale

Chiama fetch-organization e passa il nome dell’azienda nel parametro q. Senza altri parametri ricevi i dati di base per 5 crediti.

Copia la richiesta, inserisci la tua chiave ed eseguila. cURL stampa direttamente il JSON. In Python e JavaScript la risposta si trova poi in data. Con print(data["name"]) o console.log(data.name) vedi il nome dell’azienda.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: LA_TUA_CHIAVE_API" \
  --data-urlencode 'q=Hetzner Online GmbH'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "LA_TUA_CHIAVE_API"},
    params={
        "q": "Hetzner Online GmbH",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");

const response = await fetch(url, {
  headers: { "x-api-key": "LA_TUA_CHIAVE_API" },
});
const data = await response.json();

Leggi la risposta

La risposta è il profilo aziendale in JSON. Questi sono i campi che ti servono più spesso:

Leggi la risposta
Campo	Significato
entity_id	L’ID dell’azienda su handelsregister.ai. Salvalo per le richieste successive.
name, legal_form, status	Nome dell’azienda, forma giuridica e stato nel registro, nell’esempio `ACTIVE`.
registration	Tribunale del registro, tipo di registro e numero di registro, nell’esempio Ansbach HRB 6089.
address, seat	Indirizzo aziendale con coordinate, più la sede legale secondo il registro.
purpose, industry_classification	Oggetto sociale e settore secondo WZ 2008 e WZ 2025.
representation_scheme	Regole di rappresentanza: `current` vale oggi, `history` mostra ogni stato iscritto.
meta	Quanto è costata la richiesta (`request_credit_cost`) e il tuo saldo dopo (`credits_remaining`).

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "status": "ACTIVE",5  "legal_form": "GmbH",6  "registration": {7    "court": "Ansbach",8    "register_type": "HRB",9    "register_number": "6089"10  },11  "industry_classification": {12    "WZ2008": [13      {14        "code": "62.01.0",15        "label": "Erbringung von Dienstleistungen der Informationstechnologie"16      },17      {18        "code": "63.11.0",19        "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"20      },21      {22        "code": "61.90.0",23        "label": "Telekommunikation, sonstige"24      }25    ],26    "WZ2025": [27      {28        "code": "62.20.1",29        "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"30      },31      {32        "code": "46.50.1",33        "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"34      },35      {36        "code": "62.90.0",37        "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"38      }39    ]40  },41  "address": {42    "house_number": "25",43    "street": "Industriestraße",44    "postal_code": "91710",45    "city": "Gunzenhausen",46    "county": "Weißenburg-Gunzenhausen",47    "state": "Bayern",48    "country": "DEU",49    "coordinates": {50      "latitude": 49.12483,51      "longitude": 10.7805252    }53  },54  "seat": {55    "city": "Gunzenhausen"56  },57  "registration_date": null,58  "representation_scheme": {59    "current": [60      "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."61    ],62    "history": [63      {64        "value": [65          "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."66        ],67        "effective_from": "2002-10-15",68        "effective_to": "2015-07-28"69      },70      {71        "value": [72          "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."73        ],74        "effective_from": "2015-07-28",75        "effective_to": null76      }77    ]78  },79  "purpose": "Die Durchführung von Internet- und Netzwerkdienstleistungen, das Erstellen und Vertreiben von Software, der Handel mit Hard- und Software, der Betrieb einer Werbeagentur,darüber hinaus der Im- und Export von Waren aller Art, soweit sie keiner Einfuhr- oder Ausfuhrbeschränkung unterliegen und soweit keine Genehmigungen erforderlich sind.",80  "meta": {81    "request_credit_cost": 5,82    "credits_remaining": 14583  }84}

200 · Risposta di esempio per Hetzner Online GmbH, solo dati di base

Con l’entity_id interroghi in seguito direttamente la stessa azienda. È anche la chiave per fetch-document e Signals. Tribunale del registro e numero di registro sono altrettanto univoci, nell’esempio Ansbach HRB 6089.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: LA_TUA_CHIAVE_API" \
  --data-urlencode 'q=94eb910fef13f94585c48c263fa446d4'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "LA_TUA_CHIAVE_API"},
    params={
        "q": "94eb910fef13f94585c48c263fa446d4",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "94eb910fef13f94585c48c263fa446d4");

const response = await fetch(url, {
  headers: { "x-api-key": "LA_TUA_CHIAVE_API" },
});
const data = await response.json();

Come proseguire

Aggiungere feature Amministratori, soci o dati finanziari nella stessa richiesta. Recuperare un’azienda per numero di registro La via univoca tramite tribunale del registro, numero di registro ed entity_id. Concetti di base Come funzionano crediti, Tempo reale, storico e valori vuoti. Plugin ChatGPT Gli stessi dati in una chat, senza codice. Python SDK L’API in Python, con metodi pronti. Node SDK L’API in JavaScript e TypeScript.