Direct relations
get_company_relationsRetrieve a company's direct relations—statutory officers, owners, parents, subsidiaries, and M&A events—for KYB, KYC, due diligence, and risk checks without traversing the wider graph.
Instructions
Direct relations of one company — statutory officers, owners, parents, subsidiaries, M&A events — without traversing the wider graph. shareholders are owners only; members of the supervisory board are in supervisoryBoard. SK M&A events: effectiveDate is the date stated by the register; when missing, derivedEffectiveDate may carry a date INFERRED from the absorbed firm's deregistration (effectiveDateSource: "derived") — present it as an estimate, never as a register fact.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ico": "<ico>"
},
"name": "get_company_relations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ico | Yes | National registry identifier (SK/CZ IČO, AT Firmenbuch number, PL KRS/REGON, FR SIREN, …). Leading zeros are normalised server-side. | |
| country | No | ISO 3166-1 alpha-2 country of the register (e.g. SK, CZ, AT, PL). Strongly recommended: registry numbers are NOT unique across countries (an SK and a CZ company can share the same 8-digit IČO), and without it the server picks one by tie-break. | |
| purpose | No | Legal purpose for natural-person (FO) data, attested by the account holder. Only needed when the API key has full FO access; must be one of the purposes licensed on the key. Never guess it — ask the user if it is not known. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Officers, owners and corporate relations. | |
| meta | No | Request metadata: request_id (quote it in support requests), duration_ms, cached. |