# SiteCheck Company Records – Spain Empresia

> SiteCheck Company Records – Spain Empresia is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Returns a full Spanish company dossier from the Mercantile Registry (BORME) via Empresia, including CIF, CNAE, capital, directors, and financials

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/b2b/spain-empresia?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-company-records-spain-empresia-20f4db32
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VO3uW8cc_4j9w9uH6C7Rq

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 sitecheck-company-records-spain-empresia-20f4db32
```

Example prompt: Can you pull the official company record for Mercadona from the Spanish Mercantile Registry — I need their CIF, CNAE code, share capital, current directors, and whether they're still active?

## When to prefer this

Use this endpoint when you need authoritative Spanish company data sourced directly from the Mercantile Registry (BORME) via Empresia. It is the best choice for due diligence, KYC, supplier verification, or competitive research on Spanish-registered entities. Prefer it over generic web search when you need structured fields like CIF, CNAE, share capital, auditor, or current director lists with appointment dates. Use the slug parameter when you already know the Empresia identifier to skip search disambiguation.

## Known failure modes

- Company name not found in Empresia — returns empty matches list
- Ambiguous company name returns only otherMatches with no primary record
- Invalid or unknown slug returns a 404 or error response
- Officers limit parameter out of range (0-100) may return validation error
- Empresia upstream unavailable causes gateway error
- Rate limiting or payment failure returns 402 or 429

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object containing: the Empresia source URL, full company record (CIF, name, status, CNAE code and description, share capital in EUR, sales band, employee count, founding registry, last accounts year, governing body type, auditor name, phones, fax, email, websites), current officers list (name, role, appointment date, person flag) with total count, a list of other name-matched companies (name, slug, type), and a checkedAt timestamp.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "q": {
       "type": "string",
       "description": "Company name to search, e.g. telefonica, mercadona"
      },
      "slug": {
       "type": "string",
       "description": "Empresia company slug (from www.empresia.es/empresa/<slug>/) to skip the search"
      },
      "officers": {
       "type": "string",
       "description": "Max current officers to return, 0-100 (default 25)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "https://www.empresia.es/empresa/telefonica/",
  "company": {
   "cif": "A28015865",
   "fax": [
    "914827987"
   ],
   "url": "https://www.empresia.es/empresa/telefonica/",
   "cnae": {
    "code": "6420",
    "description": "Actividades de las sociedades holding"
   },
   "name": "TELEFONICA SA",
   "slug": "telefonica",
   "email": "presa@telefonica.es",
   "phones": [
    "900111004",
    "914789135"
   ],
   "status": "ACTIVA",
   "auditor": "PRICEWATERHOUSECOOPERS AUDITORES SL",
   "founded": null,
   "purpose": "Se dedica a la instalacion y explotacion de servicios telefonicoscesion del Estado el 21-12-1946.",
   "registry": "Madrid",
   "websites": [
    "www.telefonica.es",
    "www.latelefonica.es"
   ],
   "employees": 1171,
   "salesBand": "Superior a 2.500.000 euros",
   "governingBody": "Consejo de administración",
   "shareCapitalEur": 5670161554,
   "lastAccountsYear": 2025
  },
  "checkedAt": "2026-10-23T09:37:32.483Z",
  "otherMatches": [
   {
    "name": "TELEFONICA SALUD SA",
    "slug": "television-telefonia-y-telecomunicaciones-salud",
    "type": "EMPRESA"
   },
   {
    "name": "TELEFONICA CABLE SA",
    "slug": "telefonica-cable",
    "type": "EMPRESA"
   }
  ],
  "currentOfficers": {
   "list": [
    {
     "name": "Atienza Pacheco Eva Maria",
     "role": "Apod.",
     "since": "2026-07-30",
     "until": null,
     "person": true
    },
    {
     "name": "Piris Garcia Laura",
     "role": "Apod.",
     "since": "2026-06-23",
     "until": null,
     "person": true
    }
   ],
   "total": 14
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-company-records-spain-empresia-20f4db32/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)