Company registry timeline
company_historyRetrieve one company's BORME registry timeline and published events within your plan window by slug or name, with paging and merged-company history.
Instructions
Get one company's BORME timeline: its published registry events within your plan's window.
Use it once the company is known (a slug from search_companies or company_by_nif); across many companies use search_events. A name instead of a slug is searched: several matches return {ambiguous: true, candidates}, none returns {error}.
Returns JSON {company_slug, total_events, first_seen, last_seen, truncated, next_offset, count, events} (as in search_events), with former_slugs for a merged company (an old slug returns the merged timeline) and plan_window on a limited plan. total_events, first_seen and last_seen cover the whole timeline in your window, not just this page. To page, keep limit and order and pass next_offset as offset (at most 10000) until it is null.
Read-only; one request per call. Without an API key (X-API-Key header) only the last 7 days; basic covers 365 days, pro and risk the full history back to 2009. If all its events are outside your window, the refusal counts them.
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_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Events per page, integer 1-200, e.g. 20 (default 100). | |
| order | No | "desc" (default, newest first) or "asc" (oldest first), e.g. "asc" to start from the earliest event in your plan's window. | desc |
| offset | No | Events to skip, integer 0-10000 (default 0); pass the previous page's next_offset, e.g. 100. | |
| 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. |