A company's identified sole-shareholder network
company_groupGet a company's sole-shareholder network from links with no ending identified in available BORME publications. Links do not establish current ownership, control or a legal group. Use it for identified sole shareholders or connected companies; use group_history for events. Name lookup: multiple matches return {ambiguous: true, candidates}; none return {error, suggested_companies}.
Returns {company_slug, parents (nearest first), top_parent_slug, members: [{slug, name, province, status, owner_slug, depth, link_kind, since, evidence: {event_id, date, text (excerpt, max 600 chars)}}], unresolved, truncated, note}. The highest member has owner_slug, link_kind, since and evidence null. Names not matched to exactly one company appear as printed in unresolved; do not treat them as resolved companies. Max 200 members. include_directors adds director links, not members. Empty parents does not rule out control or a legal group.
Read-only. Pro plan; X-API-Key header.
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": {
"company": "<company>"
},
"name": "company_group"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company | Yes | Company slug, e.g. vaz-metales-sl (from search_companies), or a name of at least 3 letters or digits, e.g. "Mercadona". | |
| include_directors | No | Optional, one of true or false (default false), e.g. true to add legal persons appointed as directors of members and the companies a member administers, marked as director links; a director link alone does not make a company a member of the group. |