handelsregister.ai
Se connecter Créer un compte
Documentation Personnes et représentation

Personnes et représentation

Qui dirige et représente une entreprise.

Le registre nomme les personnes d’une entreprise : gérants, directoire, titulaires de la Prokura (procuration commerciale), exploitants, associés et les associés d’une KG ou d’une OHG. Le profil d’entreprise les renvoie avec la fonctionnalité related_persons (Direction). Tu obtiens les personnes actuelles et anciennes, chacune avec fonction, période et pouvoir de représentation.

Pour une personne donnée, le profil de personne renvoie davantage : toutes ses fonctions dans d’autres entreprises, ses participations et une recherche web.

Récupérer les personnes

Demande la fonctionnalité related_persons. La réponse contient alors la clé related_persons avec deux listes : current pour toutes les personnes qui exercent leur fonction aujourd’hui, et past pour toutes celles qui sont parties. Chaque fonction est une entrée distincte. Dans notre requête d’exemple pour Hetzner Online GmbH, Ansbach HRB 6089, current contenait trois gérants. Deux d’entre eux réapparaissaient dans past avec leur ancienne Prokura. Toutes les données personnelles des exemples de réponses sont des données d’exemple. 

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: TA_CLE_API" \
  --data-urlencode 'q=Hetzner Online GmbH' \
  --data-urlencode 'feature=related_persons'
1{2  "name": "Hetzner Online GmbH",3  "related_persons": {4    "current": [5      {6        "entity_id": "ea3a1670232611a992727ed067216d07",7        "label": "MANAGING_DIRECTOR",8        "role": {9          "en": {10            "long": "Managing Director",11            "short": "MD"12          },13          "de": {14            "long": "Geschäftsführer",15            "short": "GF"16          }17        },18        "name": "Paul Musterwald",19        "start_date": "2019-01-04",20        "end_date": null,21        "birth_date": "1989-07-18",22        "name_parts": {23          "given": "Paul",24          "family": "Musterwald",25          "maiden": null,26          "canonical_name": "Musterwald, Paul",27          "previous_names": null28        },29        "location": {30          "home": {31            "city": "Exempelingen i. Bay."32          }33        },34        "organization_representation_scheme": {35          "current": [36            "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."37          ],38          "history": [39            {40              "value": [41                "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."42              ],43              "effective_from": "2002-10-15",44              "effective_to": "2015-07-28"45            },46            {47              "value": [48                "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."49              ],50              "effective_from": "2015-07-28",51              "effective_to": null52            }53          ]54        },55        "role_representation_scheme": {56          "current": [57            "einzelvertretungsberechtigt."58          ],59          "history": [60            {61              "value": [62                "einzelvertretungsberechtigt."63              ],64              "effective_from": "2019-01-04",65              "effective_to": null66            }67          ]68        }69      },70      {71        "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",72        "label": "MANAGING_DIRECTOR",73        "role": {74          "en": {75            "long": "Managing Director",76            "short": "MD"77          },78          "de": {79            "long": "Geschäftsführer",80            "short": "GF"81          }82        },83        "name": "Jan Musterhuber",84        "start_date": "2019-01-04",85        "end_date": null,86        "birth_date": "1955-11-06",87        "name_parts": {88          "given": "Jan",89          "family": "Musterhuber",90          "maiden": null,91          "canonical_name": "Musterhuber, Jan",92          "previous_names": null93        },94        "location": {95          "home": {96            "city": "Probeingen"97          }98        },99        "organization_representation_scheme": {100          "current": [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          "history": [104            {105              "value": [106                "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."107              ],108              "effective_from": "2002-10-15",109              "effective_to": "2015-07-28"110            },111            {112              "value": [113                "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."114              ],115              "effective_from": "2015-07-28",116              "effective_to": null117            }118          ]119        },120        "role_representation_scheme": {121          "current": [122            "einzelvertretungsberechtigt."123          ],124          "history": [125            {126              "value": [127                "einzelvertretungsberechtigt."128              ],129              "effective_from": "2019-01-04",130              "effective_to": null131            }132          ]133        }134      },135      {136        "entity_id": "08ed5f967956831ca6588930fd2693ed",137        "label": "MANAGING_DIRECTOR",138        "role": {139          "en": {140            "long": "Managing Director",141            "short": "MD"142          },143          "de": {144            "long": "Geschäftsführer",145            "short": "GF"146          }147        },148        "name": "Max Felix Mustermann",149        "start_date": "2015-07-28",150        "end_date": null,151        "birth_date": "1976-01-15",152        "name_parts": {153          "given": "Max Felix",154          "family": "Mustermann",155          "maiden": null,156          "canonical_name": "Mustermann, Max Felix",157          "previous_names": null158        },159        "location": {160          "home": {161            "city": "Musterheim"162          }163        },164        "organization_representation_scheme": {165          "current": [166            "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."167          ],168          "history": [169            {170              "value": [171                "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."172              ],173              "effective_from": "2002-10-15",174              "effective_to": "2015-07-28"175            },176            {177              "value": [178                "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."179              ],180              "effective_from": "2015-07-28",181              "effective_to": null182            }183          ]184        },185        "role_representation_scheme": {186          "current": [187            "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."188          ],189          "history": [190            {191              "value": [192                "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen."193              ],194              "effective_from": "2015-07-28",195              "effective_to": null196            }197          ]198        }199      }200    ],201    "past": [202      {203        "entity_id": "ea3a1670232611a992727ed067216d07",204        "label": "PROCURA",205        "role": {206          "en": {207            "long": "Procura",208            "short": "Procura"209          },210          "de": {211            "long": "Prokura",212            "short": "Prokura"213          }214        },215        "name": "Paul Musterwald",216        "start_date": "2015-07-28",217        "end_date": "2019-01-04",218        "birth_date": "1989-07-18",219        "name_parts": {220          "given": "Paul",221          "family": "Musterwald",222          "maiden": null,223          "canonical_name": "Musterwald, Paul",224          "previous_names": null225        },226        "location": {227          "home": {228            "city": "Exempelingen i. Bay."229          }230        },231        "organization_representation_scheme": {232          "latest": [233            "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."234          ],235          "history": [236            {237              "value": [238                "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."239              ],240              "effective_from": "2002-10-15",241              "effective_to": "2015-07-28"242            },243            {244              "value": [245                "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."246              ],247              "effective_from": "2015-07-28",248              "effective_to": null249            }250          ]251        },252        "role_representation_scheme": {253          "latest": [254            "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"255          ],256          "history": [257            {258              "value": [259                "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"260              ],261              "effective_from": "2015-07-28",262              "effective_to": "2019-01-04"263            }264          ]265        }266      },267      {268        "entity_id": "dd7e94b41f78de4195cc70c6b0f732f3",269        "label": "PROCURA",270        "role": {271          "en": {272            "long": "Procura",273            "short": "Procura"274          },275          "de": {276            "long": "Prokura",277            "short": "Prokura"278          }279        },280        "name": "Jan Musterhuber",281        "start_date": "2015-07-28",282        "end_date": "2019-01-04",283        "birth_date": "1955-11-06",284        "name_parts": {285          "given": "Jan",286          "family": "Musterhuber",287          "maiden": null,288          "canonical_name": "Musterhuber, Jan",289          "previous_names": null290        },291        "location": {292          "home": {293            "city": "Probeingen"294          }295        },296        "organization_representation_scheme": {297          "latest": [298            "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."299          ],300          "history": [301            {302              "value": [303                "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."304              ],305              "effective_from": "2002-10-15",306              "effective_to": "2015-07-28"307            },308            {309              "value": [310                "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."311              ],312              "effective_from": "2015-07-28",313              "effective_to": null314            }315          ]316        },317        "role_representation_scheme": {318          "latest": [319            "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"320          ],321          "history": [322            {323              "value": [324                "Gesamtprokura gemeinsam mit einem anderen Prokuristen:"325              ],326              "effective_from": "2015-07-28",327              "effective_to": "2019-01-04"328            }329          ]330        }331      },332      {333        "entity_id": "08ed5f967956831ca6588930fd2693ed",334        "label": "BOARD",335        "role": {336          "en": {337            "long": "Board Member",338            "short": "Board"339          },340          "de": {341            "long": "Vorstandsmitglied",342            "short": "Vorstand"343          }344        },345        "name": "Max Felix Mustermann",346        "start_date": "2002-10-15",347        "end_date": "2015-07-28",348        "birth_date": "1976-01-15",349        "name_parts": {350          "given": "Max Felix",351          "family": "Mustermann",352          "maiden": null,353          "canonical_name": "Mustermann, Max Felix",354          "previous_names": null355        },356        "location": {357          "home": {358            "city": "Musterheim"359          }360        },361        "organization_representation_scheme": {362          "latest": [363            "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."364          ],365          "history": [366            {367              "value": [368                "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."369              ],370              "effective_from": "2002-10-15",371              "effective_to": "2015-07-28"372            },373            {374              "value": [375                "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."376              ],377              "effective_from": "2015-07-28",378              "effective_to": null379            }380          ]381        },382        "role_representation_scheme": {383          "latest": [384            "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"385          ],386          "history": [387            {388              "value": [389                "einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"390              ],391              "effective_from": "2002-10-15",392              "effective_to": "2015-07-28"393            }394          ]395        }396      }397    ]398  }399}
200 · Exemple de réponse : Hetzner Online GmbH avec la fonctionnalité related_persons, raccourci au nom et aux personnes
Champ
Champ Signification Exemple Disponibilité
related_personsobject|null Toutes les personnes inscrites de l’entreprise, réparties entre current et past.related_persons – toujours
related_persons.currentarray Personnes qui exercent leur fonction aujourd’hui. – comme ci-dessus
related_persons.pastarray Personnes parties, avec les mêmes champs que current. Dans les deux règles de représentation, latest remplace current : la dernière version avant leur départ.Vide si personne n’est parti depuis l’inscription – le plus souvent

Champs d’une personne

Chaque entrée de current et past a les mêmes champs. Sans mode temps réel, une personne a le même entity_id dans tous les profils d’entreprise et dans le profil de personne. Tu peux ainsi la reconnaître d’une entreprise à l’autre. Les personnes issues d’une requête en temps réel ont leurs propres identifiants.

Champ
Champ Signification Exemple Disponibilité
related_persons.current[].entity_idstring|null Identifiant de la personne. Sans mode temps réel, il est le même dans tous les profils d’entreprise et correspond à l’entity_id du profil de personne.related_persons "ea3a1670232611a992727ed067216d07" toujours
related_persons.current[].labelstring Fonction sous forme de valeur fixe. D’autres valeurs sont possibles.Valeurs: MANAGING_DIRECTOR gérant (Geschäftsführer), TEMPORARY_MANAGING_DIRECTOR gérant d’urgence (Notgeschäftsführer), BOARD membre du directoire (Vorstand), BOARD_CHAIR président du directoire, DIRECTOR directeur exécutif, par exemple d’une SE, PROCURA fondé de pouvoir (Prokurist), LIQUIDATOR liquidateur, INSOLVENCY_ADMINISTRATOR administrateur judiciaire de l’insolvabilité, REPRESENTATIVE représentant permanent, FULLY_LIABLE_PARTNER associé indéfiniment responsable (persönlich haftender Gesellschafter), LIMITED_PARTNER commanditaire (Kommanditist), PARTNER associé, OWNER exploitant (Inhaber), PROPRIETOR exploitant (Inhaber), TREASURER trésorier d’une association, SECRETARY secrétaire d’une association, YOUTH_WARDEN responsable jeunesse d’une association, WATER_WARDEN garde des eaux d’une association, OTHER autre fonction "MANAGING_DIRECTOR" comme ci-dessus
related_persons.current[].roleobject Nom de la fonction pour l’affichage, en de et en, chacun en version longue (long) et courte (short), par exemple Geschäftsführer et GF. – comme ci-dessus
related_persons.current[].namestring Nom complet tel qu’il figure au registre. "Paul Musterwald" comme ci-dessus
related_persons.current[].name_partsobject Le nom décomposé en ses éléments, pour le tri et le rapprochement. – comme ci-dessus
related_persons.current[].name_parts.givenstring|null Prénom, tous s’il y en a plusieurs. "Paul" comme ci-dessus
related_persons.current[].name_parts.familystring|null Nom de famille. "Musterwald" comme ci-dessus
related_persons.current[].name_parts.canonical_namestring|null Le nom, généralement sous la forme « Nom de famille, Prénom », pour le tri et le rapprochement. "Musterwald, Paul" comme ci-dessus
related_persons.current[].name_parts.maidenstring|null Nom de naissance.Vide si aucun n’est inscrit null rarement
related_persons.current[].name_parts.previous_namesarray|null Noms antérieurs de la personne sous forme de liste.Vide si aucun n’est inscrit null comme ci-dessus
related_persons.current[].titlesarray Titres universitaires, par exemple Dr. La clé manque si aucun titre n’est inscrit. – comme ci-dessus
related_persons.current[].birth_datestring|null Date de naissance au format YYYY-MM-DD, telle qu’inscrite.Vide si aucune date n’est inscrite "1989-07-18" le plus souvent
related_persons.current[].locationobject|null Lieux de la personne. – comme ci-dessus
related_persons.current[].location.home.citystring|null Lieu de résidence, tel qu’inscrit. Le registre ne contient pas d’adresse complète.Vide si aucun lieu de résidence n’est inscrit "Exempelingen i. Bay." comme ci-dessus
related_persons.current[].start_datestring|null Début de la fonction au format YYYY-MM-DD.Vide si le début n’est pas connu, par exemple avec le mode temps réel "2019-01-04" comme ci-dessus
related_persons.current[].end_datestring|null Fin de la fonction. Renseignée pour les personnes de past.Vide si la fonction existe encore null toujours

Gérants et directoire

Les gérants (Geschäftsführer) d’une GmbH ou d’une UG ont le label MANAGING_DIRECTOR. Tu reconnais le directoire (Vorstand) d’une AG, d’une SE ou d’une eG à BOARD, son président à BOARD_CHAIR. Quand une société est dissoute, les liquidateurs avec LIQUIDATOR reprennent la représentation.

Vérifie toujours les fonctions par label. Les textes de role sont destinés à l’affichage.

Prokura

La Prokura est la procuration commerciale inscrite qui permet de représenter l’entreprise dans presque toutes les affaires. Les fondés de pouvoir (Prokuristen) ont le label PROCURA. Si quelqu’un peut agir seul ou seulement conjointement avec d’autres figure dans role_representation_scheme, par exemple « Gesamtprokura gemeinsam mit einem Vorstandsmitglied » (Prokura conjointe avec un membre du directoire).

Associés indéfiniment responsables

Dans une KG, une OHG et une KGaA, les associés indéfiniment responsables (persönlich haftende Gesellschafter) représentent la société. Ils ont le label FULLY_LIABLE_PARTNER. Les commanditaires (Kommanditisten) d’une KG figurent au registre avec LIMITED_PARTNER, l’exploitant d’un e.K. avec OWNER, les associés d’une PartG ou d’une eGbR avec PARTNER.

Dans une GmbH & Co. KG, le commandité est généralement lui-même une GmbH. Tu trouves ses gérants dans le profil d’entreprise de cette GmbH.

Fonctions par forme juridique

Les fonctions d’une entreprise découlent de sa forme juridique. Le tableau montre les labels que tu vois typiquement par forme juridique. Tous les labels avec leur signification figurent ci-dessus sous label.

Forme juridique
Forme juridique Labels typiques
GmbH, UG MANAGING_DIRECTOR, PROCURA, en liquidation LIQUIDATOR
AG, SE BOARD, BOARD_CHAIR, PROCURA
KGaA FULLY_LIABLE_PARTNER, PROCURA
GmbH & Co. KG LIMITED_PARTNER, PROCURA
KG, OHG FULLY_LIABLE_PARTNER, pour une KG LIMITED_PARTNER, PROCURA
e.K. OWNER
eG BOARD, BOARD_CHAIR, PROCURA
PartG, eGbR PARTNER
e.V. BOARD

Pouvoir de représentation

Chaque personne arrive avec deux jeux de règles. role_representation_scheme est son propre pouvoir, par exemple « einzelvertretungsberechtigt » (peut représenter seul). organization_representation_scheme est la règle générale de l’entreprise, identique à representation_scheme dans les données de base. Les deux ont current et history ; pour les anciennes personnes, latest remplace current.

Champ
Champ Signification Exemple Disponibilité
related_persons.current[].role_representation_schemeobject Le pouvoir de représentation propre à la personne, par exemple « einzelvertretungsberechtigt » (peut représenter seul) ou une dispense du § 181 BGB. current est la version en vigueur, history les modifications avec value, effective_from et effective_to.related_persons – le plus souvent: GmbH, UG, AG, SE, KGaA, GmbH & Co. KG, KG, OHG, eG, PartG
rarement: e.K.
related_persons.current[].organization_representation_schemeobject Les règles générales de représentation de l’entreprise, incluses avec chaque personne. Structuré comme role_representation_scheme. – toujours: GmbH, UG, GmbH & Co. KG, KG, OHG, eG, PartG
le plus souvent: AG, SE, KGaA, e.K.

Personnes avec le mode temps réel

Avec realtime_mode=handelsregister-default, les personnes actuellement inscrites viennent directement du Handelsregister, même sans la fonctionnalité related_persons. Seul le mode temps réel est alors facturé, pas la fonctionnalité. La réponse ne contient que current.

Dans cette liste, start_date et end_date sont vides, les noms peuvent être plus courts, et l’entity_id d’une personne peut différer de celui obtenu sans mode temps réel. Rapproche les personnes par nom et date de naissance.

Si tu demandes le mode temps réel et related_persons ensemble, current provient de la requête en direct et past du profil d’entreprise. La fonctionnalité est alors aussi facturée.

Champ
Champ Signification Exemple Disponibilité
related_persons.current[].name_parts.aliasesarray Graphies du nom issues de la requête en direct, sous la forme « Nom de famille, Prénom ». Uniquement avec le mode temps réel.related_persons – toujours

Profil de personne

Le profil de personne (fetch-person) décrit une personne : ses fonctions dans toutes les entreprises auxquelles elle est liée, et ce que disent d’elle les sources web publiques. Tu trouves la personne par son nom et une entreprise dans laquelle elle exerce ou a exercé une fonction.

Le profil de personne est inclus dans chaque abonnement de crédits à partir de Plus. Une requête prend souvent dix à trente secondes, car nous faisons des recherches sur le web. Règle le délai d’attente de ton client sur au moins 120 secondes. 

curl -G "https://handelsregister.ai/api/v1/fetch-person" \
  -H "x-api-key: TA_CLE_API" \
  --data-urlencode 'person_q=Max Mustermann' \
  --data-urlencode 'organization_q=Hetzner Online GmbH'
1{2  "entity_id": "08ed5f967956831ca6588930fd2693ed",3  "name": "Max Felix Mustermann",4  "birth_date": "1976-01-15",5  "name_parts": {6    "given": "Max Felix",7    "family": "Mustermann",8    "maiden": null,9    "canonical_name": "Mustermann, Max Felix",10    "previous_names": null11  },12  "location": {13    "home": {14      "city": "Musterheim"15    }16  },17  "bio": "Max Felix Mustermann ist Geschäftsführer der Hetzner Online GmbH und Unternehmer im Bereich Rechenzentren.",18  "expertise": [19    "Rechenzentren",20    "Hosting"21  ],22  "contact": {23    "emails": [24      {25        "address": "[email protected]",26        "type": "organization",27        "label": "Allgemeine Unternehmenskontakt-E-Mail"28      },29      {30        "address": "[email protected]",31        "type": "organization",32        "label": "E-Mail für Produktfeedback"33      }34    ],35    "phones": [36      {37        "number": "+49374574447100",38        "type": "organization",39        "entity": "Hetzner Online GmbH",40        "label": "Öffentliche Unternehmens-Telefonnummer"41      },42      {43        "number": "+49911234226100",44        "type": "organization",45        "entity": "Hetzner Online GmbH",46        "label": "Öffentliche Unternehmens-Telefonnummer"47      },48      {49        "number": "+4998315050",50        "type": "organization",51        "entity": "Hetzner Online GmbH",52        "label": "Zentrale Unternehmensnummer"53      }54    ]55  },56  "profiles": {57    "linkedin": null,58    "other": []59  },60  "affiliations": [61    {62      "organization": "ENSoXX Holding AG",63      "relation": "Vorstandsmitglied"64    },65    {66      "organization": "Hetzner Online GmbH",67      "relation": "Geschäftsführer"68    },69    {70      "organization": "ENSoXX hilft e.V.",71      "relation": "Vorstandsmitglied"72    },73    {74      "organization": "TRAIDY UG (haftungsbeschränkt)",75      "relation": "Geschäftsführer"76    },77    {78      "organization": "HT clean energy GmbH",79      "relation": "Geschäftsführer"80    },81    {82      "organization": "DreamSoXX GmbH",83      "relation": "Geschäftsführer"84    },85    {86      "organization": "Lighthouse GmbH",87      "relation": "Prokura"88    },89    {90      "organization": "ENSoXX GmbH",91      "relation": "Geschäftsführer"92    },93    {94      "organization": "ENSoXX Invest GmbH",95      "relation": "Geschäftsführer"96    },97    {98      "organization": "Sonnenkraft Merkendorf GmbH & Co. KG",99      "relation": "Kommanditist"100    },101    {102      "organization": "Modellsportclub Gunzenhausen e.V.",103      "relation": "Vorstandsmitglied"104    },105    {106      "organization": "possum Projekt 1 GmbH",107      "relation": "Prokura"108    }109  ],110  "handelsregister_roles": [111    {112      "entity_id": "94eb910fef13f94585c48c263fa446d4",113      "name": "Hetzner Online GmbH",114      "label": "BOARD",115      "role": {116        "en": "Board Member",117        "de": "Vorstandsmitglied"118      },119      "start_date": "2002-10-15",120      "end_date": "2015-07-28"121    },122    {123      "entity_id": "0b3435f83ce8591300625100815d4583",124      "name": "Hetzner Online GmbH",125      "label": "BOARD",126      "role": {127        "en": "Board Member",128        "de": "Vorstandsmitglied"129      },130      "start_date": "2002-10-15",131      "end_date": "2015-07-28"132    },133    {134      "entity_id": "0b3435f83ce8591300625100815d4583",135      "name": "Hetzner Online GmbH",136      "label": "MANAGING_DIRECTOR",137      "role": {138        "en": "Managing Director",139        "de": "Geschäftsführer"140      },141      "start_date": "2015-07-28",142      "end_date": null143    },144    {145      "entity_id": "94eb910fef13f94585c48c263fa446d4",146      "name": "Hetzner Online GmbH",147      "label": "MANAGING_DIRECTOR",148      "role": {149        "en": "Managing Director",150        "de": "Geschäftsführer"151      },152      "start_date": "2015-07-28",153      "end_date": null154    },155    {156      "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",157      "name": "ENSoXX GmbH",158      "label": "MANAGING_DIRECTOR",159      "role": {160        "en": "Managing Director",161        "de": "Geschäftsführer"162      },163      "start_date": "2015-08-14",164      "end_date": null165    },166    {167      "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",168      "name": "ENSoXX Holding AG",169      "label": "BOARD",170      "role": {171        "en": "Board Member",172        "de": "Vorstandsmitglied"173      },174      "start_date": "2016-02-03",175      "end_date": null176    },177    {178      "entity_id": "bc1c1e106ade810eb960c779d4c752a8",179      "name": "ENSoXX hilft e.V.",180      "label": "BOARD",181      "role": {182        "en": "Board Member",183        "de": "Vorstandsmitglied"184      },185      "start_date": "2017-02-24",186      "end_date": null187    },188    {189      "entity_id": "b34f5fcc114e7d4c5fe9d5f6f8fb0d10",190      "name": "TRAIDY UG (haftungsbeschränkt)",191      "label": "MANAGING_DIRECTOR",192      "role": {193        "en": "Managing Director",194        "de": "Geschäftsführer"195      },196      "start_date": "2022-03-14",197      "end_date": null198    },199    {200      "entity_id": "4cd425f9ad57d6119f704ba53131b480",201      "name": "Modellsportclub Gunzenhausen e.V.",202      "label": "BOARD",203      "role": {204        "en": "Board Member",205        "de": "Vorstandsmitglied"206      },207      "start_date": "2023-06-06",208      "end_date": "2026-08-12"209    },210    {211      "entity_id": "0e8b1b4fc27a3ecc07d397750505e7b5",212      "name": "ENSoXX Invest GmbH",213      "label": "MANAGING_DIRECTOR",214      "role": {215        "en": "Managing Director",216        "de": "Geschäftsführer"217      },218      "start_date": "2023-12-13",219      "end_date": null220    },221    {222      "entity_id": "2ab71b59057969183dd811adf9f32ebd",223      "name": "HT clean energy GmbH",224      "label": "MANAGING_DIRECTOR",225      "role": {226        "en": "Managing Director",227        "de": "Geschäftsführer"228      },229      "start_date": "2024-08-20",230      "end_date": null231    },232    {233      "entity_id": "260286ab8baa3a8977fddd56b9361c6c",234      "name": "DreamSoXX GmbH",235      "label": "MANAGING_DIRECTOR",236      "role": {237        "en": "Managing Director",238        "de": "Geschäftsführer"239      },240      "start_date": "2025-01-13",241      "end_date": null242    },243    {244      "entity_id": "7582db1f94e1538ba8f531f6a95a7f1b",245      "name": "Lighthouse GmbH",246      "label": "PROCURA",247      "role": {248        "en": "Procura",249        "de": "Prokura"250      },251      "start_date": "2025-03-25",252      "end_date": null253    },254    {255      "entity_id": "232d2ed634eef59eb21836cc47cb5645",256      "name": "Sonnenkraft Merkendorf GmbH & Co. KG",257      "label": "LIMITED_PARTNER",258      "role": {259        "en": "Limited Partner",260        "de": "Kommanditist"261      },262      "start_date": "2026-02-18",263      "end_date": null264    },265    {266      "entity_id": "64922d416b4dd7006f3c2c62efaabd5d",267      "name": "possum Projekt 1 GmbH",268      "label": "PROCURA",269      "role": {270        "en": "Procura",271        "de": "Prokura"272      },273      "start_date": "2026-09-04",274      "end_date": null275    },276    {277      "entity_id": "997f1b8314b8b56573208ae2334abb1d",278      "name": "possum Projekt 1 GmbH",279      "label": "PROCURA",280      "role": {281        "en": "Procura",282        "de": "Prokura"283      },284      "start_date": "2026-09-04",285      "end_date": null286    }287  ],288  "meta": {289    "request_credit_cost": 15,290    "credits_remaining": 145291  }292}
200 · Exemple de réponse : profil de personne de Max Felix Mustermann (données d’exemple) chez Hetzner Online GmbH, raccourci

La personne

Le nom, la date de naissance et le lieu de résidence proviennent du registre. L’entity_id est le même que dans related_persons des profils d’entreprise sans mode temps réel.

Champ
Champ Signification Exemple Disponibilité
entity_idstring Identifiant de la personne. Le même identifiant apparaît dans related_persons des profils d’entreprise sans mode temps réel.Profil de personne "08ed5f967956831ca6588930fd2693ed" toujours
namestring Nom complet tel qu’il figure au registre. "Max Felix Mustermann" comme ci-dessus
birth_datestring|null Date de naissance au format YYYY-MM-DD, telle qu’inscrite.Vide si aucune date n’est inscrite "1976-01-15" le plus souvent
name_partsobject Le nom décomposé en ses éléments, structuré comme dans related_persons. – toujours
name_parts.givenstring|null Prénom, tous s’il y en a plusieurs. "Max Felix" comme ci-dessus
name_parts.familystring|null Nom de famille. "Mustermann" comme ci-dessus
name_parts.canonical_namestring|null Le nom, généralement sous la forme « Nom de famille, Prénom », pour le tri et le rapprochement. "Mustermann, Max Felix" comme ci-dessus
name_parts.maidenstring|null Nom de naissance.Vide si aucun n’est inscrit null rarement
name_parts.previous_namesarray|null Noms antérieurs de la personne sous forme de liste.Vide si aucun n’est inscrit null comme ci-dessus
locationobject Lieux de la personne. – le plus souvent
location.home.citystring|null Lieu de résidence, tel qu’inscrit.Vide si aucun lieu de résidence n’est inscrit "Musterheim" comme ci-dessus

Fonctions et liens

handelsregister_roles liste chaque fonction inscrite de la personne avec l’entreprise et sa période. Utilise l’entity_id d’une entreprise pour récupérer son profil d’entreprise. affiliations résume brièvement les liens, issus du registre et du web.

Champ
Champ Signification Exemple Disponibilité
handelsregister_rolesarray Les fonctions inscrites de la personne avec entreprise et période, actuelles et anciennes.Profil de personne – toujours
handelsregister_roles[].entity_idstring entity_id de l’entreprise, pour un profil d’entreprise dans le paramètre q. "0b3435f83ce8591300625100815d4583" comme ci-dessus
handelsregister_roles[].namestring Nom de l’entreprise. "Hetzner Online GmbH" comme ci-dessus
handelsregister_roles[].labelstring Fonction sous forme de valeur fixe, les mêmes valeurs que label dans related_persons, par exemple MANAGING_DIRECTOR, BOARD, PROCURA ou LIMITED_PARTNER. "BOARD" comme ci-dessus
handelsregister_roles[].roleobject Nom de la fonction pour l’affichage, sous forme de texte en de et en. – comme ci-dessus
handelsregister_roles[].start_datestring|null Début de la fonction au format YYYY-MM-DD.Vide si le début n’est pas connu "2002-10-15" le plus souvent
handelsregister_roles[].end_datestring|null Fin de la fonction.Vide si la fonction existe encore "2015-07-28" toujours
affiliationsarray Les entreprises auxquelles la personne est liée, chacune avec le type de lien. Résumé à partir du registre et de sources web. – comme ci-dessus
affiliations[].organizationstring Nom de l’entreprise. "ENSoXX Holding AG" comme ci-dessus
affiliations[].relationstring Type de lien sous forme de texte allemand, par exemple Geschäftsführer (gérant), Prokura ou Kommanditist (commanditaire). "Vorstandsmitglied" comme ci-dessus

Recherche web

Nous collectons la brève biographie, les domaines d’expertise, les moyens de contact et les sources à partir de sources web publiques. Leur quantité dépend de la visibilité de la personne sur le web.

Champ
Champ Signification Exemple Disponibilité
biostring|null Brève biographie de la personne en une ou deux phrases, en allemand.Vide si le web contient trop peu d’informations sur la personne (alors null)Profil de personne "Max Felix Mustermann ist Geschäftsführer der Hetzner Onl…" le plus souvent
expertisearray Domaines d’expertise et thèmes de la personne sous forme de liste.Vide si le web contient trop peu d’informations sur la personne – comme ci-dessus
contactobject Moyens de contact publiés, avec e-mails et téléphones. – toujours
contact.emailsarray Adresses e-mail sous forme de liste.Vide si aucune adresse n’a été trouvée – rarement
contact.emails[].addressstring L’adresse e-mail. "[email protected]" comme ci-dessus
contact.emails[].typestring Type d’adresse. organization signifie : une adresse de l’entreprise, pas une adresse privée. "organization" comme ci-dessus
contact.emails[].labelstring L’usage de l’adresse, en texte court. "Allgemeine Unternehmenskontakt-E-Mail" comme ci-dessus
contact.phonesarray Numéros de téléphone sous forme de liste.Vide si aucun numéro n’a été trouvé – comme ci-dessus
contact.phones[].numberstring Le numéro, généralement au format international. "+49374574447100" comme ci-dessus
contact.phones[].typestring Type de numéro. organization signifie : un numéro de l’entreprise. "organization" comme ci-dessus
contact.phones[].entitystring L’entreprise à laquelle appartient le numéro. "Hetzner Online GmbH" comme ci-dessus
contact.phones[].labelstring L’usage du numéro, par exemple standard ou fax. "Öffentliche Unternehmens-Telefonnummer" comme ci-dessus
profilesobject Pages web sur la personne, avec linkedin et other. – toujours
profiles.linkedinstring|null Adresse du profil LinkedIn.Vide si aucun n’a été trouvé null rarement
profiles.otherarray Autres pages sur la personne, par exemple articles de presse ou pages d’équipe, sous forme de liste d’adresses.Vide si aucune n’a été trouvée – le plus souvent
Une IA compile ces informations à partir de sources publiques. Nous utilisons pour cela les technologies les plus récentes et investissons beaucoup dans la qualité ; des erreurs isolées restent possibles.

Participations et réseau

Deux fonctionnalités complètent le profil de personne : shareholdings montre les entreprises dans lesquelles la personne détient des participations. network montre les entreprises et personnes auxquelles elle est liée, sur deux niveaux. Les deux ne sont facturées que si elles renvoient des données.

Champ
Champ Signification Exemple Disponibilité
shareholdingsobject|null Entreprises dans lesquelles la personne détient aujourd’hui des participations.Vide si aucune participation n’est connueshareholdings – en partie
shareholdings.holdings.currentarray Les participations actuelles sous forme de liste. – comme ci-dessus
shareholdings.holdings.current[].organizationobject L’entreprise avec entity_id, name, status, legal_form, address et registration, structurée comme dans les données de base. – comme ci-dessus
shareholdings.holdings.current[].ownership.percentagenumber|null Part du capital en pourcentage, par exemple 33.33. 100 comme ci-dessus
shareholdings.holdings.current[].ownership.contributionobject|null Valeur nominale de la participation avec montant et devise. – comme ci-dessus
shareholdings.holdings.current[].as_ofstring|null Date de l’information au format YYYY-MM-DD. "2025-01-13" comme ci-dessus
shareholdings.summary.total_currentinteger Nombre de participations actuelles. 3 comme ci-dessus
networkobject|null Entreprises et personnes auxquelles la personne est liée, sur deux niveaux. Structuré comme network dans le profil d’entreprise.network · à partir de Pro · Bêta – le plus souvent
network.depthinteger Nombre de niveaux couverts par le réseau, comptés à partir de la personne. La personne elle-même est au niveau 0. 2 comme ci-dessus
network.nodesarray Les nœuds : personnes (PERSON) et entreprises (ORGANIZATION) avec entity_id, nom et niveau. La personne elle-même a is_root à true. – comme ci-dessus
network.connectionsarray Les liens entre deux nœuds, chacun avec kind (ROLE, OWNERSHIP ou GROUP), label, période et is_current. – comme ci-dessus

Ensuite

fetch-organization L’endpoint avec la fonctionnalité related_persons et le mode temps réel. fetch-person Récupérer le profil de personne : paramètres, coûts et erreurs. Trouver dirigeants et associés Pas à pas, de l’entreprise à ses personnes. Associés et participations À qui appartient une entreprise et dans quoi elle détient des participations.