Locate BORME Section I acto-inscripción entries for a Spanish company
list_actos_inscritosSearch BORME-A province PDFs for statutory registered acts of a specific company (by exact denominación social). Retrieve director appointments, resignations, capital changes, dissolution, and other inscritos acts not available through standard company search.
Instructions
Scans BORME Section I (Empresarios — Actos inscritos) and Section B (Otros actos) province PDFs across a date range, returns every acto paragraph whose header line exactly matches the given denominación. Use this to recover current/historical directors, resignations, constitución details, sole-shareholder declarations, capital changes, dissolution, extinción — all statutory registered acts, which are NOT exposed by the per-company /buscar/anborme.php search (that indexes only Section II Anuncios y avisos legales).
Each hit includes the verbatim acto_numero (BOE's in-year sequential), borme_a_id (BORME-A-YYYY-NNN-PP province bulletin), provincia title, source_pdf_url, pagina_inicial/final, denominacion_upstream (as printed, including accent/punctuation drift), and texto_raw — the complete paragraph text from the {Nº} - {DENOMINACIÓN}. header to the next acto boundary. The adapter does NOT parse specific fields (Nombramientos / Ceses / Socio único / Capital / Datos registrales) — read texto_raw and extract inline.
Performance: each day in the range costs ~N province PDF fetches (N ≤ 52 provinces but typically 20–40). Default window: last 30 days. Hard cap: 90 days per call. Chunk longer windows client-side. Supported on ES only. Cached on the VM (PDFs are immutable once published).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jurisdiction | Yes | 'ES' only. | |
| company_id | Yes | Exact denominación social as emitted by the BORME header line — legal-form suffix required (e.g. 'ALICANTE PARK SL.', 'TELEFÓNICA, S.A.', 'REPSOL, S.A.'). Matching is accent-insensitive and treats '.', ',', and whitespace as interchangeable separators, but it is NOT substring matching — 'FOO SL' will not match 'FOO HOLDING SL'. Call search_companies first to obtain the canonical form surfaced in recent Section II publications. | |
| date_from | No | Start of the scan window, ISO YYYY-MM-DD. Defaults to 30 days before today. | |
| date_to | No | End of the scan window, ISO YYYY-MM-DD. Defaults to today. | |
| limit | No | Max acto entries to return (default 50, max 200). | |
| cursor | No | Pagination cursor from a previous response. | |
| act_types | No | Pre-filter acto paragraphs by canonical act-type key (or raw Spanish verbatim substring). Supported keys: 'nombramiento', 'cese', 'dimision', 'revocacion', 'adm-unico', 'liquidador', 'apoderado', 'poderes', 'consejero', 'auditor', 'socio-unico', 'unipersonalidad', 'ampliacion-capital', 'reduccion-capital', 'capital', 'constitucion', 'disolucion', 'extincion', 'transformacion', 'modificacion-estatutos', 'cambio-denominacion', 'cambio-domicilio', 'cambio-objeto-social', 'fusion', 'escision', 'cesion-global', 'concurso', 'prorroga'. Unrecognised keys are treated as case/accent-insensitive Spanish substring match against texto_raw (power-user escape hatch). | |
| province_filter | No | Restrict the scan to these BORME-A province codes (2-digit PP suffix of 'BORME-A-YYYY-NNN-PP'; e.g. '03'=Alicante, '28'=Madrid, '08'=Barcelona). Empty → adapter consults its per-company province cache, falling back to all provinces on miss. Use this when you already know the company's Registro Mercantil. | |
| bypass_province_cache | No | Disable the per-company province cache for this call. Useful when a company has moved domicilio and previous cache would miss new actos. | |
| fresh | No | Bypass the PDF extraction and sumario caches. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| queried_at | Yes | ISO-8601 + Europe/London timezone stamp for when the registry was queried. | |
| jurisdiction | No | ||
| company_id | No | ||
| count | No | ||
| actos | No | ||
| data | No |