# Sirenic Spanish BORME Company Acts by Hoja Registral

> Sirenic Spanish BORME Company Acts by Hoja Registral is a paid API for AI agents from api.sirenic.eu, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns the full history of official corporate acts for a Spanish company from the BORME gazette, keyed by hoja registral (e.g. VI-23141), including incorporations, officer changes, capital events, mergers, dissolutions, and insolvency filings.

## Facts

- Endpoint: GET https://api.sirenic.eu/v1/eu/entreprise/ES/:hoja/actes
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sirenic-spanish-borme-company-acts-by-hoja-registral-c453c257
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t3gtAfGxk9e79_VFgkYT7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sirenic-spanish-borme-company-acts-by-hoja-registral-c453c257
```

Example prompt: Can you pull the full list of official BORME acts for Spanish company with hoja registral M-869868 — I want to see all officer appointments, capital changes, and any dissolution or insolvency filings since they were incorporated?

## When to prefer this

Use this endpoint when you need the official, authoritative corporate act history for a Spanish company and you have the hoja registral identifier. It is the primary source for governance events (officer changes, capital events, insolvency) sourced directly from BORME since 2009. Prefer this over generic company search when you already know the hoja registral and need structured act-level detail rather than a summary profile.

## Known failure modes

- Invalid or malformed hoja registral format — returns an error if the province-number format is not recognized
- Unknown hoja registral — returns empty results or 404 if the register key does not exist in BORME data
- Province transfer edge case — a company that transferred province will have a new hoja and the old one may return partial history
- No acts found — newly registered companies or those with no published acts return an empty list
- Rate limiting or payment failure — x402 payment not completed results in 402 response

## How this service works

Spanish company acts from the official BORME gazette (Registro Mercantil, section A) by hoja registral — the register key, e.g. VI-23141: incorporations, officer appointments and dismissals (role + name), capital changes, mergers, dissolutions, insolvency. Daily filings flow since 2009, newest first (100 max + total count). Spanish personal IDs (DNI/NIE) and natural-person sole-shareholder names are redacted at ingestion. Basado en datos de la Agencia Estatal Boletin Oficial del Estado (boe.es).

## Output

A JSON array of up to 100 corporate acts for the specified Spanish company, ordered newest first, with a total count. Each act includes the act type (e.g. incorporation, officer appointment/dismissal with role and name, capital change, merger, dissolution, insolvency), the date published in the BORME, and relevant details. Spanish personal IDs (DNI/NIE) and natural-person sole-shareholder names are redacted.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "hoja"
     ],
     "properties": {
      "hoja": {
       "type": "string",
       "description": "Spanish hoja registral, {PROVINCE}-{NUMBER} (VI-14412, M-869868, VI-20755-BIS); space or lowercase accepted and normalised. NEVER a NIF/CIF: the BORME does not publish it. Get the hoja from /v1/eu/recherche?pays=ES. A province transfer opens a NEW hoja."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sirenic-spanish-borme-company-acts-by-hoja-registral-c453c257/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.sirenic.eu](https://www.zero.xyz/host/api.sirenic.eu/llms.txt)