# Vextorium Spain Company Registry

> Vextorium Spain Company Registry 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-19).

Retrieves newly registered or recently active companies from Spain's official BORME registry, filtered by province, event type, and date

## Facts

- Endpoint: POST https://api.vextorium.com/v1/spain-company-registry?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-spain-company-registry-7959fb29
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A4k-9jDnTpqs-XEa_2di5

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 vextorium-spain-company-registry-7959fb29 -d '<json body>'
```

Example prompt: Pull the latest 100 newly incorporated companies in Barcelona from the Spanish BORME registry — I want their names, addresses, capital, and corporate purpose.

## When to prefer this

Use this endpoint when you need structured data on Spanish companies from the official BORME gazette — especially for monitoring new incorporations, dissolutions, mergers, or capital changes by province and date. It is the authoritative government source for Spanish corporate events, making it preferable to third-party business databases when accuracy, recency, and official sourcing matter.

## Known failure modes

- Invalid or misspelled province name returns empty or error response
- Date with no published BORME issue returns no results
- Limit out of range (below 1 or above 500) causes validation error
- Province with no matching act type on given date returns empty company list
- Network timeout or upstream BORME availability issue causes failure

## 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 list of companies matching the query, each with company name, registry number, street address, share capital in EUR, operations start date, corporate purpose text, and the types of acts filed. Also includes aggregate counts by act type, total notices in that gazette edition, the query date, and a direct link to the official BORME publication.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "string",
   "description": "YYYY-MM-DD (default latest publication)"
  },
  "type": {
   "enum": [
    "incorporation",
    "dissolution",
    "dissolution_final",
    "insolvency",
    "capital_increase",
    "address_change",
    "merger"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "description": "Companies (1-500, default 50)"
  },
  "search": {
   "type": "string",
   "description": "Text in company name (optional)"
  },
  "province": {
   "type": "string",
   "description": "Province, e.g. Madrid, Barcelona, Valencia"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-10-02",
  "found": 102,
  "source": "Spanish Official State Gazette agency, BORME (open data). Company data only.",
  "province": "MADRID",
  "companies": [
   {
    "acts": [
     "Incorporation",
     "Single-shareholder declaration"
    ],
    "number": 440256,
    "address": "PASEO DE LA CASTELLANA 93 8 - EDIFICIO CADAGUA (MADRID)",
    "company": "GEP DELTA LOGISTICS SPAIN SL",
    "capital_eur": 3000,
    "operations_start": "2.09.26",
    "corporate_purpose": "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 "
   },
   {
    "acts": [
     "Incorporation",
     "Appointments"
    ],
    "number": 440260,
    "address": "C/ GENERALITAT VALENCIANA 3 (BOADILLA DEL MONTE)",
    "company": "TULPIA ADVISORY SL",
    "capital_eur": 5000,
    "operations_start": "5.08.26",
    "corporate_purpose": "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"
   }
  ],
  "by_act_type": {
   "Appointments": 102,
   "Incorporation": 102,
   "Single-shareholder declaration": 68
  },
  "official_link": "https://www.boe.es/diario_borme/txt.php?id=BORME-A-2026-191-28",
  "total_notices": 532
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-spain-company-registry-7959fb29/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)
