Data
DATA
network
Reference of the network feature of fetch-organization and fetch-person: the relationship network of an entity as a graph of nodes and connections. Requires a Pro or Max plan; charged only when at least one connection is returned.
Root object
| Key | Type | Description |
|---|---|---|
| depth | number | Maximum depth of the returned graph (observed: 2). |
| nodes | array | All nodes of the graph including the root entity. |
| connections | array | All connections between the nodes. |
nodes[]
| Key | Type | Description |
|---|---|---|
| node_id | string | ID of the node within the graph; referenced by connections. |
| entity_id | string | Stable entity ID; usable with fetch-organization or fetch-person. |
| type | string | Node type: ORGANIZATION or PERSON. |
| name | string | Name of the entity. |
| depth | number | Distance from the root: 0 = root, 1 = direct connection, 2 = second-order connection. |
| is_root | boolean | true for the queried entity. |
connections[]
| Key | Type | Description |
|---|---|---|
| source / target | object | Endpoints of the connection with node_id, entity_id, type and name. For OWNERSHIP the direction points from the shareholder (source) to the held company (target). |
| connection_type | string | Connection type: OWNERSHIP (shareholding), ROLE (officer/function) or GROUP (group reference). |
| label | string | Finer role code, e.g. MANAGING_DIRECTOR, PROCURA, SHAREHOLDER, AFFILIATED_COMPANY, BOARD_CHAIR (open list). |
| role | object | null | Localized role name: de/en, each with long and short. |
| start_date / end_date | string | null | Start and end of the connection; end_date null for current connections. |
| is_current | boolean | true when the connection currently exists. |
| depth | number | Depth of the connection within the graph. |