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
| Check | Why it matters | In the API |
|---|---|---|
| The CIF exists and is well formed | A made-up or mistyped tax ID is the cheapest fraud to catch. | exists, format and check character |
| The company is still trading | Dissolved, insolvent or struck-off companies should not open new accounts. | status_code, status_date, status_confidence |
| The name matches what the customer typed | Catches typos and look-alike names. | name parameter: 0–100 score, match from 80 |
| The person onboarding is a current director | Shows 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 VIES | Needed for cross-border B2B invoicing. | vat=true |
| The IBAN for payouts is well formed | Rejects broken account numbers before the first transfer. | iban parameter: check digits, SEPA, Spanish bank code |
| The tax ID has not been revoked | The Tax Agency publishes revoked NIFs in the BOE. | Alert TAX_ID_REVOKED |
| Company and directors are not on sanctions lists | EU, UN and OFAC lists, updated daily. | /sanctions/screen (Business) |
How it works
A KYB flow for Spanish companies
- 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=truetoGET /companies/verify. It costs 2 requests. - 2
Decide with the hint
The response brings alerts (
flags) and adecision_hint: pass, review or fail. Use it as is, or apply your own rules to the data. - 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
| Plan | Requests | Price | For this use case |
|---|---|---|---|
| Free | 100 in total | €0 | Test lookups by CIF and the Sandbox |
| Pro | 3,000 a month | €19/month + VAT | Verification, batches and a watchlist of up to 100 companies |
| Business | 10,000 a month | €49/month + VAT | Webhooks, 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.
Related
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.