Company registry card
company_snapshotGet a company registry card, as in REST API GET /v1/companies/{slug}.
Use it for officers (current roles from published acts), sole_shareholder as printed, capital_eur, address, status, NIF with its source, public_contracts and a size_hint estimate. For dated acts use company_history. Names are searched as in company_history: multiple matches return {ambiguous: true, candidates, candidate_names with name, province and status}; no match returns {error, suggested_companies}.
Returns company_slug, current_name, nif, nif_caveat, sources and other card fields; former_slugs for a merged company. lei: GLEIF Legal Entity Identifier matched by NIF; null means no match yet. website: from the newest BORME act about the company website; null if none or removed. BORME does not report minority shareholdings, employee counts or revenue.
Read-only; one request per call. Requires basic plan or higher; send your API key in X-API-Key (https://bormeapi.com/account).
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_snapshot"
}
}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", searched case-insensitively as in company_history. | |
| include_inferred | No | Optional, default false, e.g. true. true allows an inferred sector when the snapshot has no CNAE code: the newest eligible decision among the company's latest 500 events without a printed code fills `cnae` with a CNAE-2009 division, `cnae_version` `2009`, `cnae_source` `jev` and `cnae_inference` (`confidence`, `model`, `prompt`, `section`, `note`, `event_id`, `date`); with none eligible, none is added. It is the output of a language model (TypeSafe Jev, model `typesafe-ai/jev-1.14.0`, prompt ID `two-stage-v1`), not a code published in BORME, and it describes the objeto social, not the company's verified activity. Only decisions whose confidence meets the threshold are returned (default 0.9). Inferred values are included only on request: if you omit `include_inferred` or set it to `false`, there are none. Only acts published from 2024-11-05 have inferred divisions (`note`), so more sector coverage from that date may reflect them and does not, by itself, show market growth. |