fetch-person
Reference of the fetch-person payload: the person’s register data enriched with AI-derived web information. Fields such as bio, expertise, contact and profiles come from publicly available web sources and vary in completeness per person.
Person
| Key | Type | Description |
|---|---|---|
| entity_id | string | Stable person ID. |
| name | string | Full name. |
| name_parts | object | Name components: given, family, maiden, canonical_name, previous_names. |
| birth_date | string | Date of birth. |
| location.home | object | City of residence per the register (city). |
| bio | string | AI-generated short biography based on public sources. |
| expertise | array |
Areas of expertise from web sources. |
Contact & profiles (web enrichment)
| Key | Type | Description |
|---|---|---|
| contact.emails | array | Discovered email addresses: address, label (description of the source) and type (e.g. organization). |
| contact.phones | array | Discovered phone numbers: number, label, type and where applicable entity (associated company). |
| profiles.linkedin | string | null | LinkedIn profile where found. |
| profiles.website / profiles.github | string | null | Personal website or GitHub profile where found. |
| profiles.other | array |
Further profile or source URLs. |
Roles & affiliations
| Key | Type | Description |
|---|---|---|
| handelsregister_roles | array | The person’s register roles: entity_id and name of the company, label (e.g. MANAGING_DIRECTOR, PROCURA), role {de, en}, start_date, end_date (null = current). |
| affiliations | array | Affiliations in short form: organization and relation. |
shareholdings (+5 credits)
| Key | Type | Description |
|---|---|---|
| holdings.current | array | The person’s current company holdings: organization (entity_id, name, legal_form, status, address, registration), ownership {percentage, contribution} and as_of. |
| summary.total_current | number | Number of current holdings. The feature is only charged when this value is greater than 0. |
network (+25 credits, Pro/Max)
| Key | Type | Description |
|---|---|---|
| network | object | null | The person’s relationship network; identical structure to the company network (see the Company network reference page), with the person as the root. |