Démarrage rapide

Ton premier profil d’entreprise en cinq minutes.

Il te faut un compte et un terminal. À la fin, tu auras récupéré le profil d’entreprise de Hetzner Online GmbH avec une requête d’exemple, et tu sauras ce que contient la réponse.

Copier ta clé API

Crée un compte gratuit et confirme ton adresse e-mail. Tu reçois 150 crédits de départ, valables 30 jours.

Ta première clé API t’attend déjà sous Compte › Clés API. Copie-la et traite-la comme un mot de passe.

Chaque requête envoie la clé dans le header x-api-key. Les exemples utilisent TA_CLE_API à sa place.

Si l’API répond 401, la clé manque ou n’a pas été copiée entièrement. Avec 403, ton adresse e-mail n’est pas encore confirmée. Tu trouveras le lien de confirmation dans ta boîte de réception.

Récupérer un profil d’entreprise

Appelle fetch-organization et passe le nom de l’entreprise dans le paramètre q. Sans autre paramètre, tu obtiens les données de base pour 5 crédits.

Copie la requête, insère ta clé et exécute-la. cURL affiche directement le JSON. En Python et en JavaScript, la réponse se trouve ensuite dans data. Avec print(data["name"]) ou console.log(data.name), tu vois le nom de l’entreprise.

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

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "TA_CLE_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": "TA_CLE_API" },
});
const data = await response.json();

Lire la réponse

La réponse est le profil d’entreprise en JSON. Voici les champs dont tu auras le plus souvent besoin :

Lire la réponse
Champ	Signification
entity_id	L’identifiant de l’entreprise chez handelsregister.ai. Enregistre-le pour les requêtes suivantes.
name, legal_form, status	Nom de l’entreprise, forme juridique et statut au registre, dans l’exemple `ACTIVE`.
registration	Tribunal du registre, type de registre et numéro de registre, dans l’exemple Ansbach HRB 6089.
address, seat	Adresse professionnelle avec coordonnées, plus le siège selon le registre.
purpose, industry_classification	Objet social et secteur selon WZ 2008 et WZ 2025.
representation_scheme	Règles de représentation : `current` s’applique aujourd’hui, `history` montre chaque état inscrit.
meta	Ce que la requête a coûté (`request_credit_cost`) et ton solde ensuite (`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 · Exemple de réponse pour Hetzner Online GmbH, données de base uniquement

Avec l’entity_id, tu interroges plus tard directement la même entreprise. C’est aussi la clé pour fetch-document et Signals. Le tribunal du registre et le numéro de registre sont tout aussi uniques, dans l’exemple Ansbach HRB 6089.

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

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "TA_CLE_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": "TA_CLE_API" },
});
const data = await response.json();

Pour aller plus loin

Ajouter des fonctionnalités Dirigeants, associés ou données financières dans la même requête. Récupérer une entreprise par numéro de registre La voie sans ambiguïté via le tribunal du registre, le numéro de registre et l’entity_id. Notions de base Comment fonctionnent les crédits, le mode temps réel, l’historique et les valeurs vides. Plugin ChatGPT Les mêmes données dans un chat, sans code. SDK Python L’API en Python, avec des méthodes prêtes à l’emploi. SDK Node L’API en JavaScript et TypeScript.