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.

GET /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"
      }
    ]
  }
}
FieldTypeDescription
events[].datestringOfficial BORME publication date (YYYY-MM-DD format).
events[].act_typesstringCategorised corporate act type (e.g. Appointments, Capital Increase).
events[].url_pdfstringDirect 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.

GET /stats
ParameterTypeRequiredDescription
metricsstringOptionalComma-separated metrics (table below). Default: all.
provincestringOptionalCommercial Registry province: the name from /catalog (e.g. MADRID) or the INE code (e.g. 28). Without it, all of Spain.
fromstringOptionalFirst month (YYYY-MM) or year (YYYY). Default: 11 months before to. Data since 2009.
tostringOptionalLast month or year. Default: the current month.
groupstringOptionalmonth (default) or year.
MetricBORME filings
incorporationsIncorporations
dissolutionsDissolutions
extinctionsExtinctions (struck off)
insolvenciesInsolvency proceedings
capital_increasesCapital increases
capital_reductionsCapital reductions
address_changesChanges of registered address
mergersMergers

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_date is the latest day counted. Data is recalculated daily.
  • Months without filings return 0, so the series has no gaps. meta.notes is 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_notes carries 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.

GET /companies/changes Business
ParameterTypeRequiredDescription
sincedateOptionalFilings published on or after this date (YYYY-MM-DD). Default: yesterday. Up to 30 days back.
untildateOptionalFilings published on or before this date.
typesstringOptionalComma-separated change types (table below). E.g. address,dissolution,insolvency.
provincestringOptionalCommercial Registry province (e.g. MADRID).
cnaestringOptionalComma-separated CNAE prefixes (e.g. 62 or 4711,4719).
limitintegerOptionalRows per page (1-1000). Default: 500.
cursorstringOptionalmeta.next_cursor from the previous page, with the same filters.

Change types

change_typesWhat the BORME published
incorporationIncorporation
officersAppointments, resignations, revocations and re-elections of officers
addressChange of registered address
nameChange of company name
purposeChange of corporate purpose
capitalCapital increase or reduction
sole_shareholderSole-shareholder declaration or loss, change of sole shareholder
dissolutionDissolution, extinction or reactivation
insolvencyInsolvency proceedings
enforcement_insolvencyInsolvency 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
structuralMerger, demerger, conversion or absorption
registry_closureProvisional closure of the registry sheet or revoked tax ID
otherOther 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.created webhook, 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. id is 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_date is the latest day loaded.
  • Page with meta.next_cursor until has_more is false. With types, a page may hold fewer rows than limit while more remain.
  • act_types are 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.

🚀 Ready to get started?

Get your API Key in seconds and start integrating real data into your applications.

Go to Control Panel
🤖
Asistente IA En línea
¡Hola! Soy el asistente de APIEmpresas. ¿En qué puedo ayudarte hoy?