Données de base
Nom, forme juridique, inscription au registre, adresse, objet social, capital et règles de représentation : les données de base de chaque profil d’entreprise.
Les données de base décrivent qui est une entreprise : nom, forme juridique, inscription au registre, adresse, objet, capital et règles de représentation. Elles font partie des données de base et sont incluses dans chaque profil d’entreprise, sans demander de fonctionnalité.
La plupart des champs proviennent du Handelsregister (registre du commerce) et des autres registres officiels. Nous collectons aussi des mots-clés, des produits et des coordonnées sur le web. Ce qu’une entreprise doit faire inscrire dépend de sa forme juridique ; la colonne Disponibilité l’indique pour chaque champ.
Exemple
Les exemples de cette page proviennent d’une requête d’exemple pour Hetzner Online GmbH, Ansbach HRB 6089. Si son inscription change, ta propre requête renvoie d’autres valeurs.
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();
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 "keywords": [12 "Dedicated Server",13 "Cloud Hosting",14 "Webhosting",15 "Colocation",16 "Object Storage",17 "Domainregistrierung",18 "SSL-Zertifikate",19 "Web-Hosting-Unternehmen"20 ],21 "products_and_services": [22 "Dedizierte Root-Server (Dedicated Servers)",23 "Cloud-Server und virtuelle Server",24 "Managed Server",25 "Webhosting (Shared Hosting)",26 "Colocation Rack / Rechenzentrumsflächen",27 "Storage Box / Object Storage / Storage Share",28 "Domain-Registrierung",29 "SSL-Zertifikate",30 "Load Balancer",31 "DNS Console",32 "Registration Robot",33 "Custom Solutions"34 ],35 "industry_classification": {36 "WZ2008": [37 {38 "code": "62.01.0",39 "label": "Erbringung von Dienstleistungen der Informationstechnologie"40 },41 {42 "code": "63.11.0",43 "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"44 },45 {46 "code": "61.90.0",47 "label": "Telekommunikation, sonstige"48 }49 ],50 "WZ2025": [51 {52 "code": "62.20.1",53 "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"54 },55 {56 "code": "46.50.1",57 "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"58 },59 {60 "code": "62.90.0",61 "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"62 }63 ]64 },65 "contact_data": {66 "website": "https://www.hetzner.com/",67 "phone_number": "09831 5050",68 "email": "[email protected]"69 },70 "address": {71 "house_number": "25",72 "street": "Industriestraße",73 "postal_code": "91710",74 "city": "Gunzenhausen",75 "county": "Weißenburg-Gunzenhausen",76 "state": "Bayern",77 "country": "DEU",78 "coordinates": {79 "latitude": 49.12483,80 "longitude": 10.7805281 }82 },83 "seat": {84 "city": "Gunzenhausen"85 },86 "registration_date": null,87 "representation_scheme": {88 "current": [89 "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."90 ],91 "history": [92 {93 "value": [94 "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."95 ],96 "effective_from": "2002-10-15",97 "effective_to": "2015-07-28"98 },99 {100 "value": [101 "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."102 ],103 "effective_from": "2015-07-28",104 "effective_to": null105 }106 ]107 },108 "capital": {109 "current": {110 "amount": 50000,111 "currency": "EUR",112 "kind": "STAMMKAPITAL"113 },114 "history": [115 {116 "value": {117 "amount": 50000,118 "currency": "EUR",119 "kind": "GRUNDKAPITAL"120 },121 "effective_from": "2002-10-15",122 "effective_to": null123 }124 ]125 },126 "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.",127 "meta": {128 "request_credit_cost": 5,129 "credits_remaining": 145130 }131}
Nom et forme juridique
Le nom, la forme juridique et le statut décrivent l’entreprise, l’entity_id l’identifie. Enregistre l’entity_id si tu veux récupérer ou surveiller une entreprise plus tard, ou la relier à tes propres données.
| Champ | Signification | Exemple | Disponibilité |
|---|---|---|---|
| entity_idstring | L’identifiant de l’entreprise chez handelsregister.ai. Enregistre-le comme clé dans tes données. Dans le paramètre q, il correspond exactement à cette entreprise.Données de base |
"94eb910fef13f94585c48c263fa446d4" |
toujours |
| namestring | Nom de l’entreprise tel qu’il figure au registre, avec le suffixe de forme juridique. |
"Hetzner Online GmbH" |
comme ci-dessus |
| legal_formstring |
Forme juridique, généralement sous l’abréviation allemande courante. Compare sans tenir compte de la casse, car l’orthographe peut légèrement varier, par exemple oHG. Avec le mode IA, la forme complète peut apparaître. La liste montre des valeurs courantes ; il en existe d’autres.Valeurs: GmbH Gesellschaft mit beschränkter Haftung (société à responsabilité limitée), UG (haftungsbeschränkt) Unternehmergesellschaft (mini-GmbH), AG Aktiengesellschaft (société anonyme), SE Societas Europaea (société européenne), KGaA Kommanditgesellschaft auf Aktien (société en commandite par actions), GmbH & Co. KG KG avec une GmbH comme commandité, KG Kommanditgesellschaft (société en commandite), OHG Offene Handelsgesellschaft (société en nom collectif), e.K. eingetragener Kaufmann (commerçant individuel inscrit), eG eingetragene Genossenschaft (coopérative inscrite), PartG Partnerschaftsgesellschaft (société de professions libérales), aussi à responsabilité professionnelle limitée, e.V. eingetragener Verein (association inscrite), eGbR eingetragene Gesellschaft bürgerlichen Rechts (société civile inscrite) |
"GmbH" |
comme ci-dessus |
| statusstring |
Statut de l’entreprise au registre. D’autres valeurs sont possibles ; traite les valeurs inconnues comme « non active ».Valeurs: ACTIVE active, INSOLVENT en procédure d’insolvabilité, DISSOLVED dissoute, en liquidation, TERMINATED radiée du registre |
"ACTIVE" |
comme ci-dessus |
Inscription au registre
Le tribunal du registre, le type de registre et le numéro de registre identifient une entreprise. Nous les écrivons ensemble, dans notre exemple « Ansbach HRB 6089 ». Tu peux aussi les passer sous cette forme dans le paramètre q.
| Champ | Signification | Exemple | Disponibilité |
|---|---|---|---|
| registrationobject|null | L’inscription de l’entreprise au registre.Vide si le mode IA ne connaît une entreprise que par des sources web ; son entity_id commence alors par AI_TMP_Données de base | – | toujours |
| registration.courtstring | Tribunal du registre sous forme de nom de lieu, sans « Amtsgericht » (tribunal cantonal), par exemple Ansbach ou Charlottenburg (Berlin). |
"Ansbach" |
comme ci-dessus |
| registration.register_typestring |
Type de registre, c’est-à-dire le registre et, pour le Handelsregister, sa section.Valeurs: HRB Handelsregister section B : GmbH, UG, AG, SE, KGaA, HRA Handelsregister section A : e.K., OHG, KG, GmbH & Co. KG, GnR Genossenschaftsregister (registre des coopératives), PR Partnerschaftsregister (registre des sociétés de professions libérales), VR Vereinsregister (registre des associations), GsR Gesellschaftsregister (registre des sociétés) pour l’eGbR |
"HRB" |
comme ci-dessus |
| registration.register_numberstring | Numéro de registre sous forme de texte. Unique uniquement avec le tribunal du registre et le type de registre. |
"6089" |
comme ci-dessus |
| registration_datestring|null | Date d’inscription au registre, sous forme d’horodatage ISO 8601.Vide si la date n’est pas enregistrée |
"2013-03-18T00:00:00+00:00" |
le plus souvent: GmbH, UG, AG, SE, KGaA, KG, OHG, eG, PartG rarement: GmbH & Co. KG, e.K. |
Un numéro de registre n’est unique qu’avec son tribunal du registre. De nombreux tribunaux peuvent avoir le même numéro.
Adresse et siège
address est l’adresse professionnelle, seat le siège (Sitz) inscrit au registre. Les deux peuvent différer, par exemple quand une entreprise est inscrite à Munich et travaille à Gauting.
| Champ | Signification | Exemple | Disponibilité |
|---|---|---|---|
| addressobject | Adresse professionnelle de l’entreprise.Données de base | – | toujours |
| address.streetstring|null | Rue sans numéro.Vide si l’adresse se compose uniquement de la ville |
"Industriestraße" |
le plus souvent |
| address.house_numberstring|null | Numéro sous forme de texte, aussi avec un complément comme « 6 a ».Vide si l’adresse n’a pas de numéro |
"25" |
comme ci-dessus |
| address.postal_codestring|null | Code postal sous forme de texte, pour conserver les zéros initiaux.Vide si l’adresse se compose uniquement de la ville |
"91710" |
comme ci-dessus |
| address.citystring | Ville de l’adresse professionnelle. |
"Gunzenhausen" |
toujours |
| address.countystring | Arrondissement (Landkreis) ou ville-arrondissement. Absent comme clé dans certaines adresses. |
"Weißenburg-Gunzenhausen" |
le plus souvent |
| address.statestring | Land fédéral (Bundesland). Absent comme clé dans certaines adresses. |
"Bayern" |
comme ci-dessus |
| address.countrystring | Pays sous forme de code ISO 3166 à trois lettres, par exemple DEU. Absent comme clé dans certaines adresses. |
"DEU" |
comme ci-dessus |
| address.coordinatesobject | Coordonnées géographiques de l’adresse professionnelle, pour les cartes et les recherches par rayon. | – | comme ci-dessus |
| address.coordinates.latitudenumber|null | Latitude en degrés décimaux.Vide si l’adresse n’a pas pu être géocodée |
49.12483 |
comme ci-dessus |
| address.coordinates.longitudenumber|null | Longitude en degrés décimaux.Vide si l’adresse n’a pas pu être géocodée |
10.78052 |
comme ci-dessus |
| seatobject | Le siège (Sitz) de l’entreprise inscrit au registre. | – | toujours |
| seat.citystring | Ville du siège. Elle peut différer de l’adresse professionnelle. |
"Gunzenhausen" |
comme ci-dessus |
Objet social et secteur
L’objet social (Unternehmensgegenstand) figure au registre pour les GmbH, UG, AG, SE, KGaA, eG et PartG. Les GmbH & Co. KG, KG, OHG et commerçants individuels (e.K.) n’inscrivent pas d’objet. Le secteur, les mots-clés ainsi que les produits et services existent pour toutes les formes juridiques.
| Champ | Signification | Exemple | Disponibilité |
|---|---|---|---|
| purposestring|null | Objet social tel qu’il figure au registre, en allemand. Avec le mode IA, c’est un bref résumé de l’activité, aussi pour les formes juridiques sans objet inscrit.Vide si la forme juridique n’inscrit pas d’objet, par exemple KG, OHG et e.K.Données de base |
"Die Durchführung von Internet- und Netzwerkdienstleistun…" |
toujours: GmbH, UG, AG, SE, KGaA, eG, PartG jamais: GmbH & Co. KG, KG, OHG, e.K. |
| industry_classificationobject | Secteur selon la classification allemande des activités économiques (WZ), en deux versions. | – | toujours |
| industry_classification.WZ2025array | Codes de secteur selon la WZ 2025, la version actuelle. Le filtre de secteur de la recherche utilise aussi ces codes.Vide si aucun secteur n’a pu être attribué | – | le plus souvent |
| industry_classification.WZ2025[].codestring | Code WZ à cinq chiffres, par exemple 62.20.1. |
"62.20.1" |
comme ci-dessus |
| industry_classification.WZ2025[].labelstring | Nom de l’activité économique, en allemand. |
"Erbringung von Beratungsleistungen auf dem Gebiet der In…" |
comme ci-dessus |
| industry_classification.WZ2008array | Codes de secteur selon l’ancienne version WZ 2008, pour les systèmes qui l’utilisent encore.Vide si aucune attribution WZ 2008 n’existe | – | en partie |
| industry_classification.WZ2008[].codestring | Code WZ à cinq chiffres selon la WZ 2008. |
"62.01.0" |
comme ci-dessus |
| industry_classification.WZ2008[].labelstring | Nom de l’activité économique, en allemand. |
"Erbringung von Dienstleistungen der Informationstechnolo…" |
comme ci-dessus |
| keywordsarray | Mots-clés sur l’activité de l’entreprise, collectés dans des sources web publiques. Enrichis avec le mode IA.Vide si l’entreprise est peu présente sur le web | – | comme ci-dessus |
| products_and_servicesarray | Les produits et services de l’entreprise sous forme de liste, collectés dans des sources web publiques. Enrichis avec le mode IA.Vide si l’entreprise est peu présente sur le web | – | comme ci-dessus |
Avec le mode IA,
purpose contient un bref résumé de l’activité au lieu du texte du registre. Le mode IA ajoute des mots-clés ainsi que des produits et services issus du web.
Capital
Les sociétés de capitaux inscrivent leur capital social (Stammkapital ou Grundkapital), chaque modification avec sa date. current est le montant en vigueur, history les modifications par ordre chronologique. Les sociétés de personnes et les commerçants individuels n’ont pas de capital fixe ; current y vaut null et history est vide.
| Champ | Signification | Exemple | Disponibilité |
|---|---|---|---|
| capitalobject | Capital inscrit avec son historique.Données de base | – | toujours |
| capital.currentobject|null | Le montant de capital en vigueur.Vide si la forme juridique n’inscrit pas de capital fixe, par exemple KG, OHG, e.K. et PartG | – |
toujours: GmbH, UG, AG, SE, KGaA rarement: eG jamais: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.current.amountnumber | Montant sous forme de nombre, dans la devise de currency. |
50000 |
comme ci-dessus |
| capital.current.currencystring | Devise sous forme de code ISO 4217, presque toujours EUR. |
"EUR" |
comme ci-dessus |
| capital.current.kindstring |
Type de capital. D’autres valeurs sont possibles.Valeurs: STAMMKAPITAL Stammkapital (capital social) d’une GmbH ou d’une UG, GRUNDKAPITAL Grundkapital (capital social) d’une AG, SE ou KGaA, LIABILITY_SUM Haftsumme (montant de responsabilité), par exemple d’une coopérative, CONDITIONAL capital conditionnel d’une AG, dans des inscriptions anciennes |
"STAMMKAPITAL" |
comme ci-dessus |
| capital.historyarray | Tous les montants inscrits par ordre chronologique, y compris celui en vigueur. | – | comme ci-dessus |
| capital.history[].valueobject | Le montant avec amount, currency et kind, structuré comme current. | – | comme ci-dessus |
| capital.history[].value.change_amountobject | Montant de la modification selon l’inscription au registre, avec amount et currency. L’augmentation ou la réduction du capital ressort de la comparaison avec le montant précédent. | – |
en partie: AG, SE, KGaA rarement: GmbH, UG, eG jamais: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_fromstring|null | Valable à partir de ce jour, au format YYYY-MM-DD. |
"2002-10-15" |
toujours: GmbH, UG, AG, SE, KGaA rarement: eG jamais: GmbH & Co. KG, KG, OHG, e.K., PartG |
| capital.history[].effective_tostring|null | Valable jusqu’à ce jour.Vide si le montant est encore en vigueur |
"2005-02-28" |
comme ci-dessus |
Nous lisons automatiquement l’historique du capital dans les inscriptions au registre. Nous utilisons pour cela les technologies les plus récentes et investissons beaucoup dans la qualité ; des erreurs isolées restent possibles.
Règles de représentation
Les règles de représentation (Vertretungsregelung) définissent qui peut agir pour l’entreprise. La réponse les contient mot pour mot depuis le registre, en allemand. Dans notre requête d’exemple pour Hetzner Online GmbH, l’historique désignait le directoire (Vorstand) jusqu’au 28 juillet 2015, puis les gérants. Le pouvoir des personnes individuelles figure sous Pouvoir de représentation.
| Champ | Signification | Exemple | Disponibilité |
|---|---|---|---|
| representation_schemeobject | Règles générales de représentation de l’entreprise avec leur historique.Données de base | – |
toujours: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG le plus souvent: AG, SE, KGaA, e.K. |
| representation_scheme.currentarray|null | Les règles en vigueur sous forme de liste de paragraphes, mot pour mot depuis le registre.Vide si aucune règle n’est inscrite | – | comme ci-dessus |
| representation_scheme.historyarray | Toutes les versions inscrites avec leur validité, y compris celle en vigueur. | – | comme ci-dessus |
| representation_scheme.history[].valuearray | Le texte de cette version sous forme de liste de paragraphes. | – | comme ci-dessus |
| representation_scheme.history[].effective_fromstring|null | Valable à partir de ce jour, au format YYYY-MM-DD. |
"2002-10-15" |
comme ci-dessus |
| representation_scheme.history[].effective_tostring|null | Valable jusqu’à ce jour.Vide si la version est encore en vigueur |
"2015-07-28" |
comme ci-dessus |
Avec le mode temps réel,
history est vide. La version en vigueur figure dans current.
Contact et web
Les coordonnées ne figurent pas au registre. Nous les collectons sur le site web de l’entreprise. Leur existence dépend donc de ce que l’entreprise publie sur le web.
| Champ | Signification | Exemple | Disponibilité |
|---|---|---|---|
| contact_dataobject | Coordonnées issues du site web de l’entreprise.Données de base | – | toujours |
| contact_data.websitestring|null | Adresse du site web.Vide si aucun site web n’a été trouvé |
"https://www.hetzner.com/" |
en partie |
| contact_data.phone_numberstring|null | Numéro de téléphone tel que l’entreprise le publie. Le format n’est pas normalisé.Vide si aucun numéro n’a été trouvé |
"09831 5050" |
comme ci-dessus |
| contact_data.emailstring|null | Adresse e-mail générale de l’entreprise.Vide si aucune adresse n’a été trouvée |
"[email protected]" |
comme ci-dessus |
| website_contentstring|null |
Le texte du site web en Markdown, par exemple pour ta propre analyse ou un modèle de langage. Inclus avec la fonctionnalité website_content, uniquement avec le mode IA et sans frais supplémentaires.Vide si aucun site web n’a été trouvéwebsite_content |
"Dedicated Servers, Cloud & Hosting from Germany | Hetzne…" |
comme ci-dessus |
Mode temps réel
Avec realtime_mode=handelsregister-default, l’API interroge aussi le Handelsregister en direct. La réponse contient alors les personnes actuellement inscrites et _realtime_mode avec le résultat de la requête. Le mode temps réel n’est facturé que si la requête réussit, mais alors quel que soit son résultat.
| Champ | Signification | Exemple | Disponibilité |
|---|---|---|---|
| _realtime_modeobject | Résultat de la requête en temps réel. Présent dans la réponse uniquement si tu as demandé realtime_mode.Données de base | – | toujours |
| _realtime_mode.modestring | Le mode demandé, handelsregister-default. |
"handelsregister-default" |
comme ci-dessus |
| _realtime_mode.statusstring |
Indique si la requête en direct a réussi. Avec toute autre valeur, la réponse contient les données enregistrées, et le mode temps réel n’est pas facturé.Valeurs: success requête en direct réussie, les données viennent directement du Handelsregister |
"success" |
comme ci-dessus |
Une requête en temps réel prend plus de temps : règle donc le délai d’attente de ton client sur au moins 120 secondes. Si la requête en direct échoue, l’API renvoie les données enregistrées.
_realtime_mode.status n’est alors pas success, et le mode temps réel n’est pas facturé. Si la requête dure trop longtemps, tu reçois 408 sans frais ; réessaie plus tard.
Ensuite
fetch-organization
L’endpoint qui renvoie les données de base, avec paramètres et erreurs.
Personnes et représentation
Gérants, Prokura et associés avec leurs pouvoirs.
Notions de base
Comment lire current et history, null et les listes vides.
Disponibilité des données
Ce que contient le registre par forme juridique et d’où viennent les données.