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

CheckWhy it mattersIn the API
The tax ID is a real companyThe CIF identifies the seller in your DAC7 reporting.exists, legal form from the first letter
The legal name matches the shop’s detailsSellers often type a brand, not the legal name.name parameter: 0–100 score
The registered addressDAC7 asks for the seller’s primary address.Full address on Pro
The company is activeDo not pay out to a dissolved or struck-off company.status_code and its date
The VAT number is valid in VIESDAC7 lists the VAT number, and VIES is the official way to confirm it.vat=true
The person signing up is a directorUseful when they claim to act for the company.person parameter
The payout IBAN is well formedFewer failed payouts.iban parameter

How it works

A seller onboarding flow

  1. 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. 2

    Verify before activating

    Call GET /companies/verify with the name, the person and vat=true. Send review and fail to your trust team.

  3. 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. 4

    React to changes

    With the /watchlist and, 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

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

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.

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.

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