Verifying Spanish sellers on your marketplace
Selling platforms have to collect and check the details of the businesses that sell on them. For Spanish companies, the tax ID, legal name, registered address and status can be confirmed against the Commercial Registry Gazette (BORME) in one call, at sign-up and every time something changes.
Context
What you have to know about a Spanish seller
Two EU rules push marketplaces to check sellers. Under DAC7, platforms collect each reportable seller’s name, address, tax ID, VAT number and business registration number, and must check that the information is reliable, using free official tools such as VIES where they exist. Under the Digital Services Act, online marketplaces must make their best efforts to check the traders’ details against freely available official databases.
For a Spanish company, most of that information is public: the CIF, the legal name and registered office are published in the BORME, and the VAT registration can be checked in VIES. The API brings both together, so your onboarding can fill in and confirm the seller’s record instead of trusting what they typed.
Checklist
What to check, and where it comes from
| Check | Why it matters | In the API |
|---|---|---|
| The tax ID is a real company | The CIF identifies the seller in your DAC7 reporting. | exists, legal form from the first letter |
| The legal name matches the shop’s details | Sellers often type a brand, not the legal name. | name parameter: 0–100 score |
| The registered address | DAC7 asks for the seller’s primary address. | Full address on Pro |
| The company is active | Do not pay out to a dissolved or struck-off company. | status_code and its date |
| The VAT number is valid in VIES | DAC7 lists the VAT number, and VIES is the official way to confirm it. | vat=true |
| The person signing up is a director | Useful when they claim to act for the company. | person parameter |
| The payout IBAN is well formed | Fewer failed payouts. | iban parameter |
How it works
A seller onboarding flow
- 1
Prefill from the CIF
Ask the seller for the CIF first and prefill the legal name and address from
GET /companies?cif=. They only confirm. - 2
Verify before activating
Call
GET /companies/verifywith the name, the person andvat=true. Send review and fail to your trust team. - 3
Re-check the whole base
Once a year, or before your DAC7 report, run your Spanish sellers through
POST /companies/verify/batch(up to 1,000 per call). - 4
React to changes
With the
/watchlistand, on Business, webhooks, you hear when a seller is dissolved, enters insolvency or changes its directors, and can hold payouts.
Things to keep in mind
- Many sellers are sole traders (autónomos). They are not in the Commercial Registry: you can check the format of their DNI or NIE and their VAT number in VIES, but there is no registry status.
- DAC7 compliance is yours. The API gives you verified data for your checks; deciding what to collect and report is up to you and your advisers.
- Only Spanish companies. For sellers from other countries you need other sources.
Example request
One call from your backend
curl -X POST "https://spaincompanyapi.com/api/v1/companies/verify/batch" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"items": [{"cif": "A46103834", "name": "Mercadona", "ref": "seller-001"}]}'
Each row comes back with your own reference, the official name and status, and the reasons behind its result. 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
Does the API give me the business registration number for DAC7?
It gives the CIF (NIF), which is the Spanish tax and company identifier, the Commercial Registry province and the company’s BORME filings.
Can I verify sole traders?
Partly. The API checks that a DNI or NIE is well formed and, with vat=true, whether it is registered in VIES. Sole traders are not in the Commercial Registry, so there is no status or directors.
How many sellers can I check at once?
Up to 1,000 tax IDs per call with POST /companies/verify/batch (1 request per company found). Checking VIES at the same time is limited to 20 per call because the European Commission service is slow.
Will I know if a seller closes down?
Yes. Add it to your watchlist (free of requests): you can poll /watchlist/events, or on Business receive a webhook when the BORME publishes a dissolution, insolvency or strike-off.
What does it cost?
Pro is €19 + VAT a month with 3,000 requests. A single verification uses 2 requests; batch rows use 1 per company found. You can test first with 100 free requests.
Related
Verify your Spanish sellers by API
Prefill, verify and monitor Spanish companies from the CIF, with VIES and the BORME in one place. 100 free requests, no card required.