BORME API

Find the Spanish company a brand or trading name is linked to, by holder name. Searches the patent office's trademarks and commercial names (1987 to today), which BORME does not print, and returns for each the company whose name matches the holder name the office published. `commercial_name` identifies a business; `trademark` distinguishes goods or services (NESCAFÉ is not another name for Nestlé). Say which kind a hit is; do not say a company "is called" X when X is one of its products. Links are made on a normalised company name only (the office publishes no tax IDs) and only where exactly one company or registry sheet fits: present a hit as a name match, not confirmed ownership. On a hit, use company_history with the slug. Needs the basic plan or higher: send your API key in the X-API-Key header (https://bormeapi.com/account).

Trademarks and trading names linked to one company by name (slug from company_history). Answers "which trading names and trademarks does the patent office list under a holder of this company's name". The office publishes no tax IDs, so every link is a name match, not confirmed ownership. Commercial names identify a business; trademarks distinguish goods or services. An empty result is ordinary — most companies have neither on file. `limit` applies to each kind separately (newest first), so trademarks never push trading names out. `counts` is how many of each kind this answer lists, not the company's total: when `truncated` is true for a kind, more are linked than were returned — raise `limit` to see them. Needs the basic plan or higher: send your API key in the X-API-Key header (https://bormeapi.com/account).

Look up a Spanish company by its NIF/CIF tax ID. Needs the basic plan or higher: send your API key in the X-API-Key header (https://bormeapi.com/account). BORME itself has no dedicated tax-ID field: the mapping is cross-referenced from open official sources and, in some cases, taken from the text of BORME notices (more than 580,000 NIF mappings from public sources, still a minority of companies). A miss means "not matched yet", not "does not exist". On a hit, use company_history with the returned slug. If nif_caveat is present, say so and do not present the mapping as settled. A miss with reason "nif_check_character_failed" is an identifier never issued to anyone: relay that, the corrected identifier and did_you_mean. A miss with reason "not_registry_entity" has entity_type (the kind of entity or person): explain it as the response's note does. If ambiguous is true, list the candidates and ask which company is meant (records on one registry sheet in one province are one company).

Registry timeline for one company, as JSON. `company` is a slug or a name; a name with several matches returns the candidate slugs instead. An older slug of a merged company returns the merged company's whole timeline: company_slug is the current slug, former_slugs the others, and each event keeps the slug it was printed under. total_events, first_seen and last_seen describe the whole timeline within your plan's window, not just this page; truncated is true when the page holds fewer events than total_events, and next_offset starts the next page (null on the last). Page with order and offset. Without an API key this is the free plan: only the last 7 days. Send your key in the X-API-Key header (https://bormeapi.com/account) for your plan's window (full history back to 2009 on pro).

Digest of one BORME publication day: totals by event type, top provinces, and `insolvencies`: every event of the day whose act types include INSOLVENCY_DECLARATION or INSOLVENCY_STATUS, with company and province only (SUSPENSION_OF_PAYMENTS, BANKRUPTCY_LEGACY and PROVISIONAL_SHEET_CLOSURE_INSOLVENCY are not listed). An INSOLVENCY_STATUS (Situación concursal) notice can record any stage of the proceedings, from a request for a declaration to the conclusion. Call the entries insolvency-proceedings notices; before saying a company was declared insolvent, read its act's payload with search_events (date_from = date_to = that day, both act types, company_name_contains). Without an API key this is the free plan: only publication days within the last 7 days. Send your key in the X-API-Key header (https://bormeapi.com/account) for your plan's window.

All normalized event types: the enum (act_type), the original Spanish label (spanish) and its English label (english).

Sample of the latest derived risk signals (last 7 publication days, max 10 rows). Types: INSOLVENCY_FILED, ACCORDION, MASS_EXIT, OWNERSHIP_CHANGE, DISTRESS_COMBO, PHOENIX, ADDRESS_CLUSTER, AEAT_DEBTOR, PUBLIC_CONTRACT_AWARD. AEAT_DEBTOR comes from the AEAT's yearly debtors list (art. 95 bis LGT): details carry listed_on, list_year and is_current_list (true for 12 months from listed_on, a window this API sets). debt_eur is the published total of tax debts and penalties at 31 December of the year before publication. Say the company was on the list published on that date; never say the debt is still outstanding. Only companies in the Registro Mercantil matched by NIF are covered. Needs the risk plan: send your API key in the X-API-Key header (https://bormeapi.com/account). The full history is in the hosted API's /v1/signals.

Coverage and freshness report for the BORME dataset behind this server. Returns a JSON object with: events_approx and companies_approx (planner estimates, not exact tallies), coverage {from, to} (first and latest publication day held, YYYY-MM-DD), parse_completeness_last_30d (share of gazette text successfully structured over the last 30 publication days, e.g. 0.9987) and source. Open to everyone; no key needed. Use this to answer "how much data is there?", "how fresh is it?" and "can I trust date filters for period X?" before running searches. Takes no arguments; counts are estimates (fast reads), not exact tallies.

Find Spanish companies by name and return ranked company cards (slug, status, province). Use it first when the user gives a company name, then company_history with the slug. Matches current names, former names and name variants, ignoring accents, case, punctuation and the legal form. Each card's `match` is exact, prefix, contains or fuzzy (only when nothing else matched: a lead, not an identification; say so); `matched_on` says which name matched. Ranked by match, then active companies first, then the newest act. Plans: the free plan's events cover 7 days, but this search is not limited by history. Without a key a search shows 5 cards and `hidden_by_plan` counts the rest (`matches_beyond_limit`, a lower bound when `matches_is_at_least`): relay its note. The NIF is on the card from the basic plan up: send your key in the X-API-Key header. An empty answer is not proof that a business does not exist; relay the response's `note` in the user's language.

Search Spanish commercial-registry (BORME) events, newest first, as JSON. All filters are optional (see each parameter); coverage starts in 2009. Returns at most `limit` events. Barcelona prints some acts as free text under "Otros conceptos": recognised wording gets its own act type (act_type_raw stays "Otros conceptos"; fields.shareholder names a sole shareholder when the text does), and a same-entry revocation and reappointment becomes RE_ELECTIONS. Reprocessed events keep their event_id, but their acts can change. Without an API key this is the free plan: only the last 7 days, stated in plan_window. Send your key in the X-API-Key header (https://bormeapi.com/account) for your plan's window (full history on pro). An empty page may carry hidden_by_plan: matches before the plan's window (matches_before_window, matches_is_at_least, newest_hidden_date) and a note to pass on. Do not infer from an empty page that no matching events exist.