KYB for Spanish business customers in fintech and payments

When a Spanish company opens an account, applies for a card or signs up as a merchant, you need to know that it exists, that it is still trading and that the person onboarding it can act for it. Do it from the CIF in one API call, with data from the Commercial Registry Gazette (BORME).

Context

What KYB means for a Spanish company

Spanish anti-money laundering law (Law 10/2010) asks obliged entities to identify legal persons and verify that identification with reliable documents, and to know who acts on their behalf. In practice, KYB on a Spanish SL or SA comes down to a few facts that are public: the company’s tax ID (CIF), its legal name, whether it is still active, its registered office and its current directors.

All of them are published in the BORME every working day, but in Spanish and one notice at a time. The API reads every issue and gives you the current picture as JSON, so you can decide automatically and send only the doubtful cases to manual review.

Checklist

What to check, and where it comes from

CheckWhy it mattersIn the API
The CIF exists and is well formedA made-up or mistyped tax ID is the cheapest fraud to catch.exists, format and check character
The company is still tradingDissolved, insolvent or struck-off companies should not open new accounts.status_code, status_date, status_confidence
The name matches what the customer typedCatches typos and look-alike names.name parameter: 0–100 score, match from 80
The person onboarding is a current directorShows they can act for the company (a power of attorney is another route).person parameter: current director, position and date
The VAT number is registered in VIESNeeded for cross-border B2B invoicing.vat=true
The IBAN for payouts is well formedRejects broken account numbers before the first transfer.iban parameter: check digits, SEPA, Spanish bank code
The tax ID has not been revokedThe Tax Agency publishes revoked NIFs in the BOE.Alert TAX_ID_REVOKED
Company and directors are not on sanctions listsEU, UN and OFAC lists, updated daily./sanctions/screen (Business)

How it works

A KYB flow for Spanish companies

  1. 1

    At sign-up: one call

    Send the CIF, the name the customer gave you, the name of the person signing up, and optionally the IBAN and vat=true to GET /companies/verify. It costs 2 requests.

  2. 2

    Decide with the hint

    The response brings alerts (flags) and a decision_hint: pass, review or fail. Use it as is, or apply your own rules to the data.

  3. 3

    Keep watching

    Add the company to your /watchlist (up to 100 companies on Pro, 1,000 on Business). On Business, a webhook tells you when it publishes a dissolution, insolvency or change of directors.

What the API does not replace

  • Beneficial ownership. The Spanish register of beneficial owners is not open data. The API shows the sole shareholder when the BORME publishes it, not the full ownership chain.
  • Identity checks on the person. Matching a name with a director is not ID document verification: keep your IDV provider for that.
  • An official certificate. When the law requires a registry document, ask the Commercial Registry for it.
  • Sole traders (autónomos). They are not in the Commercial Registry, so there is no status or directors to check.

Example request

One call from your backend

curl "https://spaincompanyapi.com/api/v1/companies/verify?cif=A46103834&name=Mercadona&vat=true" \
  -H "X-API-KEY: YOUR_API_KEY"
Add person= with the full name of whoever is signing up to check them against the current directors. Try it first in the Sandbox (free, fixed data) with the CIF A15075062. API reference

Plans

What you need

PlanRequestsPriceFor this use case
Free100 in total€0Test lookups by CIF and the Sandbox
Pro3,000 a month€19/month + VATVerification, batches and a watchlist of up to 100 companies
Business10,000 a month€49/month + VATWebhooks, a watchlist of 1,000, risk profile, public contracts and sanctions screening

Only successful responses use requests. A verification uses 2. Full details on the pricing page.

FAQ

Frequently asked questions

Can I run KYB on a Spanish company for free?

You can test with 100 free requests and in the Sandbox. /companies/verify needs the Pro plan (3,000 requests a month for €19 + VAT); each verification uses 2 requests, so Pro covers about 1,500 verifications a month.

How fresh is the data?

The BORME is loaded every working day, the morning it is published. Each response says when the status was last confirmed and how much to trust it (status_confidence).

Does the API tell me who owns the company?

Only the sole shareholder when the BORME publishes it, which Spanish limited companies with a single owner have to register. It does not give the full beneficial ownership.

Can I check a whole portfolio of business customers?

Yes: POST /companies/verify/batch takes up to 1,000 tax IDs per call and uses 1 request per company found. With VIES, batches of up to 20.

Is there a Spanish-language version of this data?

The data comes as it is published in Spain (legal names, director positions in Spanish); field names and status codes are in English.

Automate KYB for your Spanish customers

One call with status, name match, directors, VIES and IBAN, and a pass / review / fail hint. 100 free requests, no card required.

Get free API key
🤖
Asistente IA En línea
¡Hola! Soy el asistente de APIEmpresas. ¿En qué puedo ayudarte hoy?