BORME API: registry filings as JSON
Every BORME entry linked to its company: the full filing history of a company, aggregated BORME statistics and a feed of the latest changes. What the BORME is: what is the BORME.
Base URL: https://spaincompanyapi.com/api/v1 · API key in the X-API-KEY header · Get a free API key (100 requests, no card) · Full documentation
6. BORME Act History
Get the complete chronological history of publications in the Spanish Commercial Registry (BORME) for a company. Pro, Business and Free with credits. Free without credits: 403 UPGRADE_REQUIRED.
/companies/borme
Pro
Parameters
| Field | Type | Description |
|---|---|---|
cif |
string | Required. The company CIF/NIF (e.g. B12345678). |
Success response (200 OK)
{
"success": true,
"data": {
"cif": "B12345678",
"company_name": "EMPRESA DE EJEMPLO SL",
"events": [
{
"date": "2023-11-01",
"act_types": "Nombramientos, Ceses",
"description": "Ceses/Dimisiones. Administrador único: JUAN PEREZ...",
"url_pdf": "https://www.boe.es/borme/dias/2023/11/01/pdfs/BORME-A-2023-100-28.pdf"
}
]
}
}
| Field | Type | Description |
|---|---|---|
events[].date | string | Official BORME publication date (YYYY-MM-DD format). |
events[].act_types | string | Categorised corporate act type (e.g. Appointments, Capital Increase). |
events[].url_pdf | string | Direct URL to the original PDF scan of the Official Gazette. |
4.1 BORME Statistics
How many companies are incorporated, dissolved, struck off or enter insolvency each month or year, in all of Spain or in one province, according to the filings published in the BORME. Useful for market reports, dashboards and to put a risk analysis in context.
/stats
| Parameter | Type | Required | Description |
|---|---|---|---|
metrics | string | Optional | Comma-separated metrics (table below). Default: all. |
province | string | Optional | Commercial Registry province: the name from /catalog (e.g. MADRID) or the INE code (e.g. 28). Without it, all of Spain. |
from | string | Optional | First month (YYYY-MM) or year (YYYY). Default: 11 months before to. Data since 2009. |
to | string | Optional | Last month or year. Default: the current month. |
group | string | Optional | month (default) or year. |
| Metric | BORME filings |
|---|---|
incorporations | Incorporations |
dissolutions | Dissolutions |
extinctions | Extinctions (struck off) |
insolvencies | Insolvency proceedings |
capital_increases | Capital increases |
capital_reductions | Capital reductions |
address_changes | Changes of registered address |
mergers | Mergers |
Response (200 OK)
{
"success": true,
"data": {
"province": "MADRID",
"province_code": "28",
"group": "month",
"from": "2026-08",
"to": "2026-10",
"totals": { "incorporations": 4210, "extinctions": 1187 },
"series": [
{ "period": "2026-08", "incorporations": 1085, "extinctions": 312 },
{ "period": "2026-09", "incorporations": 1912, "extinctions": 523 },
{ "period": "2026-10", "incorporations": 1213, "extinctions": 352 }
]
},
"meta": {
"source": "borme",
"last_borme_date": "2026-10-16",
"computed_at": "2026-10-16 21:05:12",
"notes": "Actos publicados en el BORME (sección A) por la fecha del boletín y la provincia del Registro. El mes en curso está incompleto. Un acto con varios tipos cuenta en cada uno."
}
}
- Counts filings in section A of the BORME by gazette date and Commercial Registry province. A filing with several types (e.g. "Disolución, Extinción") counts in each one.
- The current month is incomplete;
meta.last_borme_dateis the latest day counted. Data is recalculated daily. - Months without filings return
0, so the series has no gaps.meta.notesis in Spanish. - Dissolutions and insolvencies cannot be compared between provinces. Each Commercial Registry records these acts its own way: in September 2026 Barcelona published 36 dissolutions and 0 insolvencies, and Madrid 418 and 58, although Barcelona published 258 extinctions. Use them to follow the trend within one province. To measure closures, use
extinctions; the full insolvency record is the Registro Público Concursal. If you request these metrics,meta.metric_notescarries the warning (in Spanish). - Cost: 1 request (3 credits from a top-up). All plans. Not available in the Sandbox.
7.3 Changes Feed (Business Plan Only)
Every company with a filing published in the BORME since a given date, oldest first: to keep a CRM, an ERP or a customer database up to date without adding each company to the watchlist. Each row says what changed (change_types) and the company's current status. For the details (new directors, address...), look the company up in /companies.
/companies/changes
Business
| Parameter | Type | Required | Description |
|---|---|---|---|
since | date | Optional | Filings published on or after this date (YYYY-MM-DD). Default: yesterday. Up to 30 days back. |
until | date | Optional | Filings published on or before this date. |
types | string | Optional | Comma-separated change types (table below). E.g. address,dissolution,insolvency. |
province | string | Optional | Commercial Registry province (e.g. MADRID). |
cnae | string | Optional | Comma-separated CNAE prefixes (e.g. 62 or 4711,4719). |
limit | integer | Optional | Rows per page (1-1000). Default: 500. |
cursor | string | Optional | meta.next_cursor from the previous page, with the same filters. |
Change types
| change_types | What the BORME published |
|---|---|
incorporation | Incorporation |
officers | Appointments, resignations, revocations and re-elections of officers |
address | Change of registered address |
name | Change of company name |
purpose | Change of corporate purpose |
capital | Capital increase or reduction |
sole_shareholder | Sole-shareholder declaration or loss, change of sole shareholder |
dissolution | Dissolution, extinction or reactivation |
insolvency | Insolvency proceedings |
enforcement_insolvency | Insolvency declared by a court in an enforcement proceeding (usually a labour court: no assets were found to pay a debt). Not insolvency proceedings; the row also carries insolvency. Since 26-10-2026 |
structural | Merger, demerger, conversion or absorption |
registry_closure | Provisional closure of the registry sheet or revoked tax ID |
other | Other filings |
Success response (200 OK - Business plan)
{
"success": true,
"data": [
{
"id": "borme_act:11494608",
"date": "2026-10-08",
"cif": "B93867240",
"company_name": "BIOLIQUID DIAGNOSTICS S.L",
"change_types": ["address"],
"act_types": ["Cambio de domicilio social"],
"status_code": "ACTIVE",
"province": "Barcelona",
"cnae": null,
"borme_pdf": "https://www.boe.es/borme/dias/2026/10/08/pdfs/BORME-A-2026-195-08.pdf"
},
{
"id": "borme_act:11494733",
"date": "2026-10-08",
"cif": "B93867604",
"company_name": "TITANIA INMO S.L",
"change_types": ["officers", "dissolution"],
"act_types": ["Nombramientos", "Revocaciones", "Extinción"],
"status_code": "EXTINCT",
"province": "Barcelona",
"cnae": null,
"borme_pdf": "https://www.boe.es/borme/dias/2026/10/08/pdfs/BORME-A-2026-195-08.pdf"
}
],
"meta": {
"since": "2026-10-08",
"until": null,
"filters": { "since": "2026-10-08", "province": "BARCELONA" },
"count": 2,
"limit": 500,
"has_more": true,
"next_cursor": "eyJkIjoiMjAyNi0xMC0wOCIsImlkIjoxMTQ5NDczM30",
"last_borme_date": "2026-10-09"
}
}
Restricted response (403 Forbidden - Free and Pro plans)
{
"success": false,
"error": "PLAN_RESTRICTION",
"message": "El feed de cambios requiere el plan Business.",
"upsell_opportunities": {
"mensaje": "Desde el 01/10/2026 hay 4.812 cambios publicados en el BORME que encajan con tu búsqueda. Con el plan Business los recibes por API para mantener al día tu base de clientes.",
"upgrade_url": "https://apiempresas.es/billing?plan=business&source=api_403_changes",
"total": 4812,
"since": "2026-10-01"
}
}
- Companies with a CIF only. Newly incorporated companies rarely appear on their incorporation day, because they do not have a CIF yet (we find it a few days later). To learn about new companies, use the
company.createdwebhook, which notifies on the same day with province, CNAE and capital filters. - One row per filing: a company with two filings on the same day appears twice.
idis stable: use it to avoid processing the same change twice. - Recommended: one call a day with
since= the day of your last call. The BORME is published Monday to Friday;meta.last_borme_dateis the latest day loaded. - Page with
meta.next_cursoruntilhas_moreisfalse. Withtypes, a page may hold fewer rows thanlimitwhile more remain. act_typesare returned in Spanish, as published by the BORME. The filing text and people's names are not included: use /companies/borme for that.- Cost: 1 request per page (up to 1,000 rows). 403 responses do not use quota; the count is included in up to 25 403 responses per account per day.
More API documentation
- Authentication, plans and limits
- Spanish company lookup by CIF or name
- KYB verification and tax ID checks
- BORME API: registry filings as JSON
- Company monitoring: watchlist and webhooks
- Prospecting: new companies and segments
- Public contracts, tenders and grants
- Sanctions screening and risk profile
- MCP server for AI assistants
- SDKs, code examples and Postman
🚀 Ready to get started?
Get your API Key in seconds and start integrating real data into your applications.
Go to Control Panel