France

eKYB Prefill in France leverages France's source of truth to automatically retrieve and populate business information based on a company's SIREN, SIRET, RCS, RC, or VAT number, including the business name, registered address, entity type, registration status, directors, shareholders, and additional financial and corporate data, without requiring manual input from the user.

Source

Direct API approach

For general integration notes and shared response semantics, see the eKYB Prefill API Reference.

All module configurations and user data can be forwarded directly in the request for performing a Prefill lookup. This overrides existing configuration and data collected about the user.

Endpoint

POST /omni/externalVerification/ekyb-prefill

Request parameters

Tax ID formats

The taxId field accepts five French business identifier types. Routing between them is determined automatically by the format of the submitted value.

Inputs that do not match any of the above formats return a 400 error.

Sample request

{
    "plugins": ["ekyb-prefill"],
    "source": "FR_KYB_PREFILL",
    "country": "FR",
    "taxId": "12345678901234",
    "businessName": "Entreprise Exemple SAS",
    "address": "10 Rue de Rivoli, 75001 Paris, France"
}

Sample response

The Prefill response returns business data retrieved directly from the source of truth. Fields are returned as-is from the source. nameMatch and addressMatch are only present when businessName or address were submitted in the request. vatNo and leiNumber are only present when available on file for the company.

Example 1 — ABERMIDONE (small company)

{
  "kyb-prefill": [
    {
      "tin": "12345678901234",
      "vatNo": "FR12345678901",
      "name": "ABERMIDONE",
      "nameMatch": "Verified",
      "address": "10 Rue de Rivoli, 75001 Paris, France",
      "city": "Paris",
      "postalCode": "75001",
      "entityType": "Simplified joint stock company",
      "registrationStatus": "Active",
      "registrationDate": "2013-09-25T00:00:00Z",
      "creditRating": "B",
      "creditRatingDescription": "Low Risk",
      "industryDesc": "Retail sale via home-shopping by general catalogue",
      "activityDesc": "Retail sale via home-shopping by general catalogue",
      "employeeCount": "7 to 9 employees",
      "otherAddresses": [
        { "type": null, "otherAddress": "33185 LE HAILLAN" },
        { "type": null, "otherAddress": "75008 PARIS" }
      ],
      "shareholders": [
        { "name": "Groupe Exemple SA", "percentSharesHeld": 100 }
      ],
      "directors": [
        { "name": "Groupe Exemple SA", "positionName": "President" }
      ],
      "ultimateParent": { "name": "Groupe Exemple SA", "country": "FR" },
      "immediateParent": { "name": "Groupe Exemple SA", "country": "FR" }
    }
  ]
}

Example 2 — LVMH MOET HENNESSY LOUIS VUITTON (large public company)

{
  "kyb-prefill": [
    {
      "tin": "12345678901234",
      "vatNo": "FR12345678901",
      "leiNumber": "549300ECLIPSELUXE199",
      "name": "Maison Éclipse Luxe SAS",
      "nameMatch": "Verified",
      "address": "108 AVENUE RIVIÈRE 75008 PARIS",
      "city": "PARIS",
      "postalCode": "75008",
      "entityType": "European Company",
      "registrationStatus": "Active",
      "registrationDate": "1989-01-13T00:00:00Z",
      "creditRating": "A",
      "creditRatingDescription": "Very Low Risk",
      "industryDesc": "Activities of head offices",
      "activityDesc": "Activities of head offices",
      "turnover": { "currency": "EUR", "value": 748000000 },
      "employeeCount": "20",
      "shareholders": [
        { "name": "FINANCIÈRE ÉCLAT", "percentSharesHeld": 6.73 },
        { "name": "FAMILLE BEAUMONT", "percentSharesHeld": 0.57 }
      ],
      "directors": [
        { "name": "M BERNARD BEAUMONT", "positionName": "Chairman of the Board" },
        { "name": "Mme LYDIA ANNA-NOËLLE DUNE", "positionName": "Administrator" }
      ]
    }
  ]
}

Response fields

Name and address match values

Registration status values

Error responses

For standard HTTP response codes, see the API Error Response page. France Prefill returns the following country-specific 400 errors.

taxId is missing, empty, or does not match a supported French identifier format (SIREN, SIRET, RCS, RC, or VAT number):

{
    "timestamp": 1782851408892,
    "status": 400,
    "error": "Bad Request",
    "message": "taxId must be a valid French identifier: SIREN (9 digits), SIRET (14 digits), RCS (RCS + city + number), RC (RC + city + number), or VAT number (FR + 11 characters)",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Any mandatory field (plugins, source, country, or taxId) is missing:

{
    "timestamp": 1782851468367,
    "status": 400,
    "error": "Bad Request",
    "message": "must not be blank",
    "path": "/omni/externalVerification/ekyb-prefill"
}

No business match is found for the submitted taxId:

{
    "timestamp": 1782851583695,
    "status": 200,
    "message": "No business found matching the provided tax ID.",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Single Session Dashboard results

Prefill results are available on the Business tab in single Session view.