French E-Invoice Partner Resolver

Give it a SIRET, a SIREN or a company name. Get back the exact counterparty block a compliant French e-invoice needs — including an intracommunity VAT number that has actually been checked against the EU VIES registry, not just computed.

Why this exists

French electronic invoicing requires, for every counterparty: the exact legal name, the SIREN/SIRET, and — for B2B inside the EU — a valid intracommunity VAT number.

Those live in different places, and the VAT number is the one people get wrong. The French VAT number is derived from the SIREN by a modulo-97 key, so it can always be computed. But computing it does not prove the company is registered for intra-EU trade. Only the EU VIES registry says that, and an invoice that carries a computed-but-unregistered VAT number is the kind of thing that comes back at you months later.

This Actor does both halves, and tells you which one you got.

Input

{
  "queries": ["55203253400703", "443061841", "Blablacar"],
  "checkVat": true
}

• queries — one entry per company. 14 digits is read as a SIRET, 9 digits as a SIREN, anything else as a name (best match returned). Spaces, dots and dashes in numbers are ignored.
• checkVat — on by default. Turn it off for a faster, cheaper lookup when you only need identity and address; the VAT number is then computed but not confirmed, and the output says so.

Output

One dataset item per query:

{
  "query": "443061841",
  "query_kind": "siren",
  "found": true,
  "legal_name": "GOOGLE FRANCE",
  "siren": "443061841",
  "siret": "44306184100047",
  "vat_number": "FR64443061841",
  "vat_source": "confirmed_by_vies",
  "vat_vies_valid": true,
  "vat_vies_name": "EURL GOOGLE FRANCE",
  "naf_code": "70.10Z",
  "legal_form_code": "5499",
  "is_active": true,
  "address": "8 RUE DE LONDRES 75009 PARIS",
  "postal_code": "75009",
  "city": "PARIS",
  "country": "FR",
  "resolved_at": "2026-08-26T21:55:12.004Z"
}

The three VAT states, and why there are three

vat_source	vat_vies_valid	What it means
confirmed_by_vies	true	VIES was asked and confirmed the number. Safe to put on an invoice.
computed_not_in_vies	false	VIES was asked and said no. The company exists but is not registered for intra-EU trade under this number.
computed_from_siren	null	VIES could not be asked (it refused or was down). The number is arithmetically correct and nothing more. vies_note carries the exact reason.

null never means false here. VIES answers isValid: false both when a number is genuinely not registered and when the member state simply refused to answer (MS_MAX_CONCURRENT_REQ) — reading isValid on its own turns a refusal into a "not registered" verdict on a company that is perfectly fine. This Actor only trusts VIES when VIES says VALID or INVALID, retries once on anything else, and reports silence as silence.

Sources

• Identity, address, activity, status — recherche-entreprises.api.gouv.fr, the French government's official company search API. Free, no key.
• VAT confirmation — the European Commission's VIES REST API. Free, no key.

No scraping, no third-party paid API, no account to create anywhere.

Pricing

$0.008 per company resolved. You are charged once per query that gets a real answer — including a definitive "no such company", because that is the answer you asked for. You are not charged when our own side fails (registry unreachable, timeout): those come back with an error field and no charge.

Works well with

facturx-validator-generator (same account) — once you have a resolved counterparty block, that Actor turns invoice data into a compliant Factur-X PDF, or validates one you already have.

Limitations

• France only. The identity lookup is the French registry; the VIES check is run against the FR member state.
• A name query returns the best single match, not a list. Use a SIREN or SIRET when you need certainty about which company you got.
• VIES availability is not ours to guarantee. It goes down member state by member state, regularly. When that happens you get null and the reason, never a guess.

Related Actors

Other single-purpose checkers on this account, priced per item checked:

• Factur-X Validator & Generator — validate or build the invoice document itself.
• EU VAT Number Checker — official VIES lookup for an EU VAT number.
• IBAN Validator & Formatter — ISO 13616 length and mod-97 checksum, fully offline.
• Email Address Validator — syntax, MX and disposable-domain checks.
• Barcode Check-Digit Validator — EAN-13, EAN-8 and UPC-A check digits.