# Automating business verification (KYB)

A business-verification file is judged less on what it contains than on what it proves. /v1/kyb/{siren} returns six blocks in one call, and each declares which official registry it came from and as of which date. That per-block provenance is what lets you reconstruct a file months later, in front of an auditor, without having to take a vendor's word for it.

## The six blocks of the file

- **Identity**: legal name, form, status, creation date, head office, activity code.
- **Officers** as published in the registry.
- **Legal alerts**: insolvency proceedings, deregistrations, business sales.
- **Filed accounts**, where they exist.
- **Sanctions screening** of the company **and each of its officers** against the 6 official lists.
- **Computed VAT number** and a dossier **completeness score**.

> Screening covers the **officers** too, not just the company. That is almost always where the signal is: a sanctioned individual rarely runs a company that is itself listed.

## A whole portfolio, one call per hundred

`/v1/kyb/batch` takes 2 to 100 company numbers and returns the same file for each, at the batch unit price — cheaper than the single-call price. The quote is computed from the number of company numbers passed and frozen before settlement.

A company number with no publicly listed company comes back as `trouve=false` and counts as one lookup. The response does not hide its gaps, which is the only way to know what still needs manual work.

## The measured foundation

The file draws on 29,922,486 company numbers, 43,896,818 establishments, 9,196,396 registry filings, 6,542,232 financial years and 130,165 names across 6 official sanctions lists.

> ⚠️ For **France**, Sirenic exposes **no beneficial-ownership register**: it has not been publicly accessible since the 2022 ruling of the Court of Justice of the European Union. What we serve is ownership as it appears in **publicly filed deeds** (articles of association), with a confidence level and the source document reference. That is not a beneficial-ownership register and does not replace one.

## How you pay

Every route is paid **per call**, in USDC or EURC on the Base network, over the x402 protocol: no account to create, no API key, no subscription. The first call returns a `402` quote your client settles, then replays the call. A failed call is never billed.

Would you rather have a euro invoice and prepaid credits? That is **in preparation**, and we will not announce a date until it is open. Write to [contact@sirenic.eu](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs) and we will let you know when it opens.

Paid responses are **Ed25519-signed**: you can later prove what was served to you, and when. The whole catalogue is free to read in the [OpenAPI document](https://api.sirenic.eu/openapi.json) and in [llms.txt](https://api.sirenic.eu/llms.txt).

**One call, end to end**

```
# Client x402 (npm) — le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## Routes used and pricing

| Route | Price | What it returns |
| --- | --- | --- |
| `/v1/kyb/{siren}` | $0.15 | Company lookup KYB — Know Your Business verification of a French company in one call: official company data for due diligence, compliance and customer onboarding: identity, officers, BODACC legal alerts (insolvency, deregistration), filed financials, sanctions screening of the company and each officer against the 6 official lists, computed VAT number and a completeness score. Per-block provenance: every block states its official register and as-of date. |
| `/v1/kyb/batch` | $0.105 / entité | Batch KYB and bulk company lookup: full Know Your Business files for 2 to 100 French companies in one call (comma-separated sirens parameter) — bulk due diligence, compliance and onboarding screening of a whole portfolio, each file with per-block provenance (official register + as-of date). Billed per company at $0.105 (30% off the $0.15 unit price); the amount is quoted from the number of SIREN. A SIREN with no diffusible company is returned as trouve=false and billed as one lookup. |
| `/v1/sanctions/check` | $0.02 | Sanctions screening (AML/KYC): screen a person or company name against 6 official watchlist sources — UN consolidated, EU FSF, US OFAC SDN, UK Sanctions List, French national asset-freeze register, Swiss SECO list — six official lists in one call. Fuzzy watchlist matching with a 0-100 confidence score per hit — never a bare yes/no. Each list reports its entry count, publication date and what that date means. One AML screening call covers UN, EU, OFAC, UK, FR and CH. |
| `/v1/entreprise/{siren}/dossier` | $0.005 | Full French company file in ONE call: identity is the base, then add the blocks you want and pay only for those — etablissements, alertes_bodacc, finances, marches_publics, marches_publics_ue, lobbying, risques_industriels, agrements, pi, documents, facturation_prep, score. Example: blocs=finances,pi,score on siren 552032534. Each block costs what its own endpoint costs, total capped at $0.35. A block that cannot be served is NAMED with its reason: no data, not disclosable, or upstream outage. |

> ⚠️ Screening never returns a bare yes/no: every hit carries a 0-to-100 confidence score. Politically exposed persons are not served.

## Frequently asked questions

### Does the file include beneficial owners?

Not for France: the register has not been public since 2022. For the United Kingdom and Latvia, yes — both expose an open register, and we serve it. For France, the available route is ownership from filed articles of association, with its limits stated.

### What is the completeness score worth?

It says how much of the file could be filled from official sources. A low score is not a risk signal: very often it is simply a company that files no accounts, which is legal and common. It tells you where your analyst should look, not how to rate the company.

### Can I use it in an AML/CTF process?

As a timestamped, traceable official information source, yes. It does not replace your own obligations: as the regulated entity, you carry the risk assessment and the onboarding decision.

## Take it further

- [See a real response (free)](https://api.sirenic.eu/exemples/kyb-siren.json)
- [Get the quote for /v1/kyb/{siren}](https://api.sirenic.eu/v1/kyb/552032534)
- [Read the route reference](https://api.sirenic.eu/en/api)
- [Get notified about euro packs](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs)

## Read next

- [Screening a counterparty against sanctions lists](https://api.sirenic.eu/en/use-cases/screen-name-against-6-official-sanctions-lists)
- [Identifying a company's beneficial owners](https://api.sirenic.eu/en/use-cases/beneficial-owners-open-uk-latvia-closed-france)
- [Preparing supplier master data for the French e-invoicing mandate](https://api.sirenic.eu/en/use-cases/french-e-invoicing-get-your-supplier-master-data-ready)

---

Volume figures on this page were measured in our database on 2026-08-19. They are dated snapshots, not live counters.

Full catalogue : https://api.sirenic.eu/