# Strale Spanish Company Data API

> Strale Spanish Company Data API is a paid API for AI agents from api.strale.io, paid per call via x402, $0.054/call, status unknown (last checked 2026-09-13).

Look up official registration and firmographic data for Spanish companies by CIF/NIF tax identifier or company name

## Facts

- Endpoint: GET https://api.strale.io/x402/v2/spanish-company-data
- Price: $0.054/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/strale-spanish-company-data-api-b85337cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-p19tPcZPwp45q8ZSKQZR

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 strale-spanish-company-data-api-b85337cd
```

Example prompt: Can you look up the official registration details for the Spanish company with CIF A28015865 and tell me its legal name, registered address, and status?

## When to prefer this

Choose this endpoint when you need authoritative, auditable Spanish company data tied to official registry records, especially in compliance, KYC, or supplier verification workflows. Prefer it over generic web searches when you need structured firmographic output with a cryptographic audit trail. Best when you have a CIF/NIF or an unambiguous company name; avoid when only a vague or partial name is available since the endpoint refuses ambiguous matches.

## Known failure modes

- Ambiguous company name rejected rather than guessed — endpoint refuses to return results if name match is not confident
- Invalid or malformed CIF/NIF format returns an error (must be letter + 7 digits + check character)
- Company not found in registry returns empty or 404-equivalent response
- Missing required query parameter (no nif/cif/name/query provided) returns a 400-level error
- Rate limiting or payment failure via x402 protocol returns 402 Payment Required

## How this service works

The trust layer for AI agents — 250+ independently tested data capabilities across 27 countries. Execute capabilities via REST, MCP, A2A, or x402 micropayments. Every call returns an audit record with cryptographic chain hashing.

## Output

Returns structured JSON with official Spanish company registration data (legal name, CIF/NIF, registered address, company type, status, and other firmographic fields) plus a Strale audit record with a cryptographic chain hash for provenance verification.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ]
    },
    "queryParams": {
     "type": "object",
     "anyOf": [
      {
       "required": [
        "nif"
       ]
      },
      {
       "required": [
        "cif"
       ]
      },
      {
       "required": [
        "vat_number"
       ]
      },
      {
       "required": [
        "identifier"
       ]
      },
      {
       "required": [
        "company_name"
       ]
      },
      {
       "required": [
        "name"
       ]
      },
      {
       "required": [
        "query"
       ]
      },
      {
       "required": [
        "task"
       ]
      }
     ],
     "required": [],
     "properties": {
      "cif": {
       "type": "string",
       "description": "Alias for nif"
      },
      "nif": {
       "type": "string",
       "description": "Spanish CIF/NIF (letter + 7 digits + check char, e.g. A28015865); ES-prefixed VAT accepted"
      },
      "name": {
       "type": "string",
       "description": "Alias for company_name"
      },
      "task": {
       "type": "string",
       "description": "Free-text alias — CIF/NIF or company name"
      },
      "query": {
       "type": "string",
       "description": "Free-text alias — CIF/NIF or company name"
      },
      "identifier": {
       "type": "string",
       "description": "Alias for nif"
      },
      "vat_number": {
       "type": "string",
       "description": "Alias for nif — ES-prefix VAT format accepted (ESA28015865)"
      },
      "company_name": {
       "type": "string",
       "description": "Spanish company name (scored match — ambiguous names are refused, never guessed)"
      }
     }
    }
   },
   "required": [
    "type",
    "method"
   ],
   "additionalProperties": false
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/strale-spanish-company-data-api-b85337cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.strale.io](https://www.zero.xyz/host/api.strale.io/llms.txt)
