Daten
DATEN
network
Referenz des network-Features von fetch-organization und fetch-person: das Beziehungsnetzwerk einer Entität als Graph aus Knoten und Verbindungen. Nur mit einem Pro- oder Max-Abo verfügbar; berechnet wird nur, wenn mindestens eine Verbindung geliefert wird.
Wurzelobjekt
| Schlüssel | Typ | Beschreibung |
|---|---|---|
| depth | number | Maximale Tiefe des gelieferten Graphen (beobachtet: 2). |
| nodes | array | Alle Knoten des Graphen inklusive der Wurzel-Entität. |
| connections | array | Alle Verbindungen zwischen den Knoten. |
nodes[]
| Schlüssel | Typ | Beschreibung |
|---|---|---|
| node_id | string | ID des Knotens innerhalb des Graphen; referenziert von connections. |
| entity_id | string | Stabile Entitäts-ID; nutzbar mit fetch-organization bzw. fetch-person. |
| type | string | Knotentyp: ORGANIZATION oder PERSON. |
| name | string | Name der Entität. |
| depth | number | Abstand zur Wurzel: 0 = Wurzel, 1 = direkte Verbindung, 2 = Verbindung zweiter Ordnung. |
| is_root | boolean | true für die abgefragte Entität. |
connections[]
| Schlüssel | Typ | Beschreibung |
|---|---|---|
| source / target | object | Endpunkte der Verbindung mit node_id, entity_id, type und name. Bei OWNERSHIP zeigt die Richtung vom Anteilseigner (source) zur gehaltenen Gesellschaft (target). |
| connection_type | string | Verbindungsart: OWNERSHIP (Beteiligung), ROLE (Organ/Funktion) oder GROUP (Konzernbezug). |
| label | string | Feiner Rollen-Code, z. B. MANAGING_DIRECTOR, PROCURA, SHAREHOLDER, AFFILIATED_COMPANY, BOARD_CHAIR (offene Liste). |
| role | object | null | Lokalisierte Rollenbezeichnung: de/en, jeweils long und short. |
| start_date / end_date | string | null | Beginn und Ende der Verbindung; end_date null bei aktuellen Verbindungen. |
| is_current | boolean | true, wenn die Verbindung aktuell besteht. |
| depth | number | Tiefe der Verbindung im Graphen. |