France

France eKYB validates the legitimacy of French businesses by checking their tax ID, business name, address, UBOs, and directors against French government sources of truth.

Source

Country	Source	Description
France	French government sources of truth	Verifies submitted business details against records maintained in French registries.

Direct API approach

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

Request parameters

Parameter	Required	Description
`plugins`	Mandatory	Array. Must be `["ekyb"]`.
`businessName`	Mandatory	String. Name of the business.
`country`	Mandatory	String. Two-letter Alpha-2 country code. Must be `FR`.
`taxId`	Mandatory	String. Accepts SIREN, SIRET, RCS, RC (local numbers), or VAT Number. Format varies by type.
`street`	Optional	String. Street name of the business.
`houseNo`	Optional	String. Building or house number.
`addressLine2`	Optional	String. Second line of the business address.
`city`	Optional	String. City in the business address.
`state`	Optional	String. State in the business address.
`postalCode`	Optional	String. French postal code.
`uboNames`	Optional	Array. Full legal names of Unique Beneficial Owners to check against records associated with the business.
`directors`	Optional	Array. Full legal names of directors to check against records associated with the business.

Sample request

{
  "plugins": ["ekyb"],
  "businessName": "AUCHAN RETAIL INTERNATIONAL",
  "street": "RUE MAL DE LATTRE DE TASSIGNY",
  "city": "CROIX",
  "postalCode": "59170",
  "country": "FR",
  "taxId": "XXXXXXXXX",
  "uboNames": ["LLO", "Sarah Smith"],
  "directors": ["Andrew Martin", "Sarah Schrader"]
}

Sample response

{
  "kyb": [
    { "key": "name", "sub_label": "Verified" },
    { "key": "tin", "sub_label": "Verified", "reasonCodes": ["REGNO"] },
    { "key": "address_verification", "sub_label": "Verified" },
    { "key": "cityMatch", "sub_label": "Verified" },
    { "key": "postalCodeMatch", "sub_label": "Verified" },
    { "key": "registrationStatus", "sub_label": "Active" },
    {
      "key": "entityType",
      "entityType": { "entityType": "Limited Liability Granting Company" }
    },
    { "key": "ubo_name_match", "sub_label": "Verified", "uboName_input": "LLO" },
    { "key": "ubo_name_match", "sub_label": "Unverified", "uboName_input": "Sarah Smith" },
    { "key": "directors_name_match", "sub_label": "Verified", "directorsName_input": "Andrew Martin" },
    { "key": "directors_name_match", "sub_label": "Unverified", "directorsName_input": "Sarah Schrader" }
  ]
}

Response fields

Key	Status	Description
`name`	`Verified`, `Approximate Match`, `Unverified`	Submitted business name against the business name associated with the tax ID.
`tin`	`Verified`, `Unverified`	Submitted tax ID against the government database.
`address_verification`	`Verified`, `Approximate Match`, `Unverified`	Submitted address against the address associated with the tax ID.
`cityMatch`	`Verified`, `Approximate Match`, `Unverified`	Submitted city against the city associated with the tax ID.
`postalCodeMatch`	`Verified`, `Unverified`	Submitted postal code against the postal code associated with the tax ID.
`registrationStatus`	`Active`, `Inactive`, `Unknown`	Registration status of the business. `Inactive` includes suspended businesses and those no longer in operation.
`entityType`	Legal entity type of the business	The legal entity type of the company, if available. If not available, displays `Unknown`.
`ubo_name_match`	`Verified`, `Approximate Match`, `Unverified`	Submitted UBO against UBOs associated with the business. Distinguished by the `uboName_input` field on each entry.
`directors_name_match`	`Verified`, `Approximate Match`, `Unverified`	Submitted director against directors associated with the business. Distinguished by the `directorsName_input` field.

Error responses

See the eKYB API Reference for standard error responses.

Single Session Dashboard results

View eKYB results on the Business tab in single Session view.