Fuentio
Get a free key

Supplier Onboarding (KYB) in France and Spain in One Call

Company verification with real live answers: Peugeot SA comes back unverified because it ceased, Danone verified, Mercadona partial. Sources and proof codes.

· By the Fuentio team · 5 min read

Share image: "Supplier Onboarding (KYB) in France and Spain in One Call" on Fuentio's paper background, with the News label.

The register step of supplier onboarding asks a simple question: is this company real, and is it still trading? In France and Spain the answer sits in official registers, but reading them by hand takes time and leaves little evidence behind. Fuentio's verify_company asks the register in one call and returns a decision you can file: an outcome, the reasons, each check, the source, the check date and a proof code.

This walkthrough uses three real answers from the live server on 12 October 2026, including a well-known company that comes back unverified: exactly the answer you want.

What you'll learn

  • How to call verify_company over MCP or REST
  • How to read three real outcomes: unverified, verified and partial
  • What the proof code is for, and what to file

Short answer: call verify_company(country, identifier, reference). You get one of four outcomes (verified, partial, unverified, insufficient data) with the reasons, five checks, warning signals, the source, the check date and a proof code that retrieves the verification later. It costs 5 units, or 1 if the company isn't found.

The call

Over MCP, from an AI agent:

verify_company(country="FR", identifier="552100554", reference="blog-kyb-1")

Over REST, from your own code, the same check is POST /v1/verifications with the country, the identifier and an optional reference. The reference is your own case or supplier ID: it is stored with the verification, so the proof code ties back to your file.

For France, the identifier is the SIREN, a SIRET or the VAT number. For Spain, it is the registry sheet (hoja registral), such as V-5581; if you only have a name, search for it first with search_companies, since Spanish companies can't be looked up by their tax number.

Case 1: a company that ceased (Peugeot SA)

We verified Peugeot SA, SIREN 552100554. The live server answered:

PEUGEOT SA (FR, SIREN 552100554): unverified, inactive per Annuaire des Entreprises (API Recherche d'entreprises), checked 2026-10-12. Proof FUE-FR-20261012-YK5YXJ.

The outcome is unverified, with the reason company_inactive. Behind that line are five checks:

  • identifier valid: pass (“The ID has a valid format.”)
  • record found: pass (“Found in the official source.”)
  • status active: fail (“Register status: inactive.”)
  • address present: pass (“Registered address published.”)
  • fresh: pass (“Checked against the source within its refresh window.”)

The warning signals add the evidence: a closure signal is present, dated 16 January 2021 in the register. The source is the Annuaire des Entreprises (INSEE Sirene and the national company register), under Licence Ouverte / Etalab 2.0, and the record was last checked against it on 11 October 2026.

This is the right answer. The number is valid and the name is famous, so a naive check would pass it, but the company is ceased (cessée, the French directory's status, not a legal dissolution). A verification that says “unverified” with the reason is worth more than a green tick.

Case 2: an active company (Danone)

Same call for Danone, SIREN 552032534:

DANONE (FR, SIREN 552032534): verified, active per Annuaire des Entreprises (API Recherche d'entreprises), checked 2026-10-12. Proof FUE-FR-20261012-ABAT38.

Outcome verified, reason company_active, all five checks passed, and no closure signal found. Note what the signals also say: dissolution, extinction and insolvency are marked not_covered in this verification, not none_found. Fuentio doesn't turn “not checked here” into “nothing found”. For insolvency notices, run check_insolvency, which reads the BODACC.

Case 3: a Spanish company (Mercadona)

For Spain, we verified Mercadona by its registry sheet, V-5581:

MERCADONA SA (ES, Registro Mercantil sheet (hoja) V-5581): partial, status unknown (no dissolution act; latest act 2026-10-07) per BORME — Boletín Oficial del Registro Mercantil (Sección A), checked 2026-10-12. Proof FUE-ES-20261012-966W7X.

Outcome partial, with the reasons status_unknown and events_only_coverage. The company was found in the BORME, its address is published and the data is fresh, but the status check says “unknown”. The BORME publishes events, not a status: no dissolution act was found, and the latest act is dated 7 October 2026, but the absence of a dissolution act doesn't prove the company is active. So the verification says partial, and tells you why. In Spain, read the latest acts and their dates, and order a nota simple from the Registro Mercantil if you need a formal statement.

The proof code

Every verification gets a proof code: FUE-FR-20261012-YK5YXJ for Peugeot SA, FUE-FR-20261012-ABAT38 for Danone, FUE-ES-20261012-966W7X for Mercadona. It is stored for 24 months. GET /v1/verifications/{id or proof code} returns the verification as it was served, at no cost, so an auditor can check what you saw, when, and from which source. Read more in why every Fuentio answer carries its source, date and proof code.

One call for a list

The same call runs for every supplier in a list, from your procurement tool or from an AI agent. Adding Fuentio to Claude takes a minute: see check French and Spanish companies inside Claude.

Want to see it on your own suppliers before you build anything? Send us up to 20 through the free pilot: you get back a checked file within 24 hours, with sources, check dates, proof codes and what could not be confirmed.

Limits

  • France and Spain only.
  • No data about people: no person's name appears in any answer.
  • Spanish companies can't be looked up by NIF or CIF: search by name, then use the registry sheet.
  • Spanish records cover companies with a BORME act since 2009; their status is “unknown” unless an act says otherwise.
  • No annual accounts, no credit ratings.
  • A verification confirms what the register records. The onboarding decision stays yours.

See what we cover in France and Spain. For what each of the 17 tools does, read Fuentio is live. Questions: hello@fuentio.com.

Frequently asked questions

Why is a well-known company “unverified”?

Because the register shows it ceased. A valid number and a famous name don't make a company active.

What does “partial” mean for a Spanish company?

The company was found, but its current status can't be confirmed from BORME acts, which publish events rather than a status.

How long is a verification kept?

24 months. Its proof code retrieves it at no cost.

What does a verification cost?

5 units, or 1 unit if the company isn't found.

Sources

← All articles · RSS feed