Direct relations
get_company_relationsRead-onlyIdempotent
Direct relations of one company — statutory officers, owners, parents, subsidiaries, M&A events — without traversing the wider graph. 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.
Input Schema
TableJSON 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
TableJSON 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. |