# BORME Spain Commercial Registry Acts Lookup

> BORME Spain Commercial Registry Acts Lookup is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-13).

Retrieves official company acts (incorporations, dissolutions, capital changes, insolvencies, etc.) from Spain's BORME Commercial Registry for a given province and date

## Facts

- Endpoint: POST https://api.vextorium.com/borme-actos-pago?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/borme-spain-commercial-registry-acts-lookup-fa6e5b09
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qDqA-ImepoAn2bY0PxPTt

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 borme-spain-commercial-registry-acts-lookup-fa6e5b09 -d '<json body>'
```

Example prompt: Pull all company incorporations registered in the BORME for Madrid on 2026-10-02 — I want the company names, addresses, share capital, and business purposes, up to 100 results.

## When to prefer this

Choose this endpoint when you need official, structured data about Spanish company acts directly from the BORME (Spain's official Commercial Registry Gazette). It is the authoritative source for incorporations, dissolutions, insolvencies, capital changes, relocations, and mergers for any Spanish province on any published date. Prefer this over general web scraping when you need structured, machine-readable, legally official data with act-type filtering and name search capabilities.

## Known failure modes

- Invalid or misspelled province name returns empty results or error
- Date with no BORME publication (weekends, holidays) may return no data
- Act type enum value not matching allowed values returns validation error
- Limit out of range (below 1 or above 500) causes request failure
- Missing required 'provincia' field causes schema validation error
- Very broad searches may return truncated results at the 500-company limit

## How this service works

Company acts registered in Spain's Commercial Registry (BORME section A) for a province and day: new companies with business purpose, address and share capital, dissolutions, insolvencies, capital increases, moves... Filter by act type or name. Company data only. Official BOE open data.

## Output

Returns a JSON object with the publication date, province, total announcements count, number of companies found, a breakdown of acts by type (e.g. Constitución, Nombramientos), an official BOE link, and an array of company objects each containing the company name, BORME registry number, registered address, share capital in EUR, business purpose summary, operations start date, and the list of act types registered for that company.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "provincia"
     ],
     "properties": {
      "tipo": {
       "enum": [
        "constitucion",
        "disolucion",
        "extincion",
        "concurso",
        "ampliacion_capital",
        "cambio_domicilio",
        "fusion"
       ],
       "type": "string"
      },
      "fecha": {
       "type": "string",
       "description": "YYYY-MM-DD (default latest publication)"
      },
      "buscar": {
       "type": "string",
       "description": "Text in company name (optional)"
      },
      "limite": {
       "type": "integer",
       "description": "Companies (1-500, default 50)"
      },
      "provincia": {
       "type": "string",
       "description": "Province, e.g. Madrid, Barcelona, Valencia"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "fecha": {
       "type": [
        "string",
        "null"
       ]
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "provincia": {
       "type": [
        "string",
        "null"
       ]
      },
      "sociedades": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "actos": {
          "type": [
           "array",
           "null"
          ],
          "items": {
           "type": [
            "null",
            "string"
           ]
          }
         },
         "numero": {
          "type": [
           "null",
           "number"
          ]
         },
         "sociedad": {
          "type": [
           "null",
           "string"
          ]
         },
         "domicilio": {
          "type": [
           "null",
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fecha": "2026-10-02",
  "fuente": "Agencia Estatal Boletín Oficial del Estado, BORME (datos abiertos). Solo datos de sociedades.",
  "provincia": "MADRID",
  "sociedades": [
   {
    "actos": [
     "Constitución",
     "Declaración de unipersonalidad",
     "Nombramientos"
    ],
    "numero": 440256,
    "sociedad": "GEP DELTA LOGISTICS SPAIN SL",
    "domicilio": "PASEO DE LA CASTELLANA 93 8 - EDIFICIO CADAGUA (MADRID)",
    "capital_eur": 3000,
    "objeto_social": "La adquisición, venta, construcción, arrendamiento y gestión de bienes inmuebles, gestión de proyectos inmobiliarios, y, en general, cualquier tipo de actividad relacionada con el sector inmobiliario, excepto aquellas que requieran por ley cualquier tipo de calificación especial, licencia u ",
    "comienzo_operaciones": "2.09.26"
   },
   {
    "actos": [
     "Constitución",
     "Nombramientos"
    ],
    "numero": 440260,
    "sociedad": "TULPIA ADVISORY SL",
    "domicilio": "C/ GENERALITAT VALENCIANA 3 (BOADILLA DEL MONTE)",
    "capital_eur": 5000,
    "objeto_social": "a) La adquisición, suscripción, tenencia, disfrute y enajenación de acciones y participaciones sociales de sociedades mercantiles en general\". (CNAE: 64.21: Actividad de las sociedades holding); b) La dirección, gestión, control y administración de su cartera de sociedades participadas, como socieda",
    "comienzo_operaciones": "5.08.26"
   },
   {
    "actos": [
     "Constitución",
     "Nombramientos"
    ],
    "numero": 440275,
    "sociedad": "ESTUDIO MONTECARMELO MIRASIERRA SL",
    "domicilio": "AVDA DE FRANCIA 169 - PORTAL 3, 3ºC (ARROYOMOLINOS)",
    "capital_eur": 3000,
    "objeto_social": "Otras actividades inmobiliarias por cuenta de terceros (CNAE 68,32). Y además, las siguientes actividades:- Agentes de la propiedad inmobiliaria, en la que se incluye la intermediación en la compra, venta y alquiler de bienes inmuebles por cuenta de terceros.- La promoción inmobiliaria.- Los servici",
    "comienzo_operaciones": "2.09.26"
   }
  ],
  "encontrados": 102,
  "anuncios_total": 532,
  "enlace_oficial": "https://www.boe.es/diario_borme/txt.php?id=BORME-A-2026-191-28",
  "por_tipo_de_acto": {
   "Constitución": 102,
   "Nombramientos": 102,
   "Declaración de unipersonalidad": 68
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/borme-spain-commercial-registry-acts-lookup-fa6e5b09/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)
