KYB Essentials — Spain
Quick verification of a Spanish company. Confirms the company exists in the official registry, validates VAT registration (from registry data or a VAT number you provide), screens against international sanctions lists, and checks LEI status.
kyb-essentials-es What it runs
- Spanish Company Data
Source: OpenMercantil.es — BORME-derived register (Agencia Estatal BOE primary source), Tier-2 vendor aggregation
- EU VAT Validation
Source: VIES (EU VAT Information Exchange System, European Commission)
- Sanctions Check
Source: Dilisense consolidated (OFAC SDN, EU FSF, UN SC, UK Sanctions List, CH SECO, BIS, World Bank, EBRD, ADB + 125 national sanctions/debarment lists; full attribution at https://dilisense.com/en/sources/sanction-sources)
- LEI Lookup
Source: GLEIF (Global Legal Entity Identifier Foundation)
The answer returns every step’s result, so your agent can show or check each one.
Inputs
| Field | Type | Required | What it is |
|---|---|---|---|
vat_number | string | No | EU VAT number with country prefix (e.g. ATU14189108). Optional — used for VIES validation when the registry lookup does not return one (e.g. AT, SK); auto-derived from registry data where possible. |
company_name | string | Yes | Spanish company name or CIF |
How to call it
# Needs an API key. The whole check is charged once, at the listed price.
curl -X POST https://api.strale.io/v1/solutions/kyb-essentials-es/execute \
-H "Authorization: Bearer $STRALE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"inputs": {
"company_name": "Banco Santander"
},
"max_price_cents": 150
}' # No account. The first request answers 402 with the price in USDC;
# an x402 client pays it from your wallet and repeats the request.
curl -i -X POST https://api.strale.io/x402/v2/solutions/kyb-essentials-es \
-H 'Content-Type: application/json' \
-d '{
"company_name": "Banco Santander"
}' The bundle’s published example input.
Limitations
Coverage comes from BORME acts published from about 2009 and includes about 2.8 million mainly small, medium and operating companies. Some major listed parent companies with no acts in that window are missing even when their subsidiaries are covered; absent companies return an error.
From step: Spanish Company Data
What to do instead: For listed parents, use lei-lookup (GLEIF) or the CNMV's public issuer registry
Records are derived from official BORME acts and retain references to those acts, but the normalised record is supplied by a third party rather than an official registry. Confirm critical facts against the cited act or a Registro Mercantil extract.
From step: Spanish Company Data
What to do instead: Confirm critical facts against the BORME act cited in the record or a Registro Mercantil extract
Officers are derived from BORME appointment, re-election and cessation acts, so missing cessation notices or appointments before coverage can leave an incorrect list. Dates of birth are not available.
From step: Spanish Company Data
The source is operated by a single provider without a service agreement, uptime commitment or indemnification. Its availability and the accuracy of its normalisation can affect results.
From step: Spanish Company Data
The source allows 200 requests per day, and each company lookup uses two requests, allowing about 100 lookups daily. Exhausted quota returns a retry-later error rather than a partial answer.
From step: Spanish Company Data
What to do instead: Retry after the daily quota resets and reuse existing results when their age suits the task.
VIES can be unavailable or throttle requests under unpublished per-member-state limits. Transient faults are retried, and cached results, including older fallback results, can be returned during outages.
From step: EU VAT Validation
What to do instead: Lookups within 48 hours can use cached results; if VIES is unavailable and no cached result exists, retry later.
Results can be cached for 48 hours, and national registry changes can take a further 24 hours to appear in VIES. Check the national tax authority directly for same-day registration or deregistration confirmation.
From step: EU VAT Validation
What to do instead: For real-time same-day verification, contact the national tax authority directly.
Swiss UID validation returns valid or invalid only, without a company name or address. This tool does not perform the separate enrichment lookup, whose public service is limited to 20 requests per minute.
From step: EU VAT Validation
What to do instead: For Swiss company name + address, call the swiss-company-data capability.
GB VAT numbers return a credentials-pending error when the HMRC connection is not configured.
From step: EU VAT Validation
What to do instead: Use vat-format-validate for GB format checks; it does not confirm VAT registration.
Sanctions lists updated daily from OFAC, EU, and UN sources — newly sanctioned entities may take up to 24 hours to appear
From step: Sanctions Check
What to do instead: For same-day compliance, subscribe to OFAC's RSS feed and cross-reference against today's additions
Name matching uses fuzzy logic — common names may produce false positives. Always verify flagged results
From step: Sanctions Check
What to do instead: Filter results by match confidence score and verify flagged entities against the primary sanctions list PDF
Covers entities with LEI registration via GLEIF — only ~2.5 million entities worldwide have LEIs, primarily financial institutions
From step: LEI Lookup
What to do instead: If no LEI is found, search by company name and jurisdiction; consider that smaller entities may not have an LEI