French Due Diligence

Checks a French SIREN (9 digits), SIRET (14 digits) or intra-EU VAT number (FR + 11 characters): format, checksum, and whether the registered company or establishment exists. Use it first when an identifier was typed by a person.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 9,
      "maxLength": 32,
      "description": "SIREN, SIRET or FR VAT number; spaces allowed"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Checks live in VIES, the European Commission's VAT register, whether a French VAT number (or the VAT number of a SIREN or SIRET) is valid, with the name and address declared for VAT, crossed with the French registry: company active, insolvency proceeding, and a name_matches consistency signal between the VIES name and the registered name (not a proof of ownership). To confirm the number belongs to a given company, compare the returned names with that company's name. Pass requester_vat (the user's own EU VAT number) to get a VIES consultation number, proof of the check. vies.status 'unavailable' means VIES could not answer: try again later, it does not mean invalid.

{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "minLength": 9,
      "maxLength": 32,
      "description": "FR VAT number, SIREN or SIRET; spaces allowed"
    },
    "requester_vat": {
      "description": "The user's own EU VAT number, e.g. DE811569869, for a consultation number",
      "type": "string",
      "minLength": 4,
      "maxLength": 32
    }
  },
  "required": [
    "number"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Finds French companies by name, optionally narrowed by department (e.g. 75, 2A, 971), postal code or NAF activity code (e.g. 10.71C). Returns up to 10 companies with their SIREN. Use get_company next for the full profile.

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Company name, 3 characters minimum",
      "type": "string",
      "minLength": 3,
      "maxLength": 100
    },
    "department": {
      "type": "string",
      "pattern": "^(\\d{2}|2A|2B|97[1-6])$"
    },
    "postal_code": {
      "type": "string",
      "pattern": "^\\d{5}$"
    },
    "activity_code": {
      "description": "NAF rév. 2 code",
      "type": "string",
      "pattern": "^\\d{2}\\.?\\d{2}[A-Z]$"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Profile of a French company by SIREN: legal name and form, activity, active or ceased, head office, officers (name and role), whether an insolvency proceeding is ongoing (in_insolvency) and its latest BODACC court announcements. Use it to answer 'can I do business with this company?'.

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string"
    }
  },
  "required": [
    "siren"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Screens a French company and its officers (people, with their month of birth, and companies) against the French national asset-freeze register (registre national des gels: UN, EU and French measures). result is clear, possible_match or strong_match; each match gives the register entry, its legal bases and its official page. A match is a lead to check on that page, not a decision; a different date of birth already rules namesakes out. strong: a person with the same name and year and month of birth, or a company whose own SIREN or SIRET the register entry lists; a same-named company without it is only possible. Beneficial owners, foreign lists (OFAC, UK) and politically exposed persons are not covered.

{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "minLength": 9,
      "maxLength": 32,
      "description": "SIREN, SIRET or FR VAT number; spaces allowed"
    }
  },
  "required": [
    "number"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Public contracts a French company won (DECP, French public procurement data): their count, the summed maximum amounts (leaving out amounts the source flags as suspect or aberrant, given apart), first and latest notification, then the contracts newest first, 20 per page, with buyer, object, maximum amount, CPV code, procedure, duration and place; plus the company's name, whether it is active and whether an insolvency proceeding is ongoing. Amounts are ceilings declared by buyers (maximum estimated, excl. VAT), not spend or revenue; the count is approximate (computed by the source: a contract held by two establishments counts twice, and a holder whose identifier merely contains the SIREN may be included). Narrow with from and to (notification dates).

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string"
    },
    "from": {
      "description": "Notified on or after, YYYY-MM-DD",
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "to": {
      "description": "Notified on or before, YYYY-MM-DD",
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "page": {
      "description": "Page of 20 contracts, from 1",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "siren"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

One establishment of a French company by SIRET: address, NAF activity, open or closed, head office or not. Use it to check a supplier's or invoice's address.

{
  "type": "object",
  "properties": {
    "siret": {
      "type": "string"
    }
  },
  "required": [
    "siret"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

For a French postal address, returns each dwelling's energy performance certificate (DPE) and its rental verdict under the Climate and Resilience law: rentable now or not, rent frozen or not, ban date (G 2025, F 2028, E 2034), DPE validity, and the label estimated under current electricity rules. Narrow with floor, surface or address complement. Information, not legal advice.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "minLength": 5,
      "maxLength": 200,
      "description": "Full address with house number, postcode and town"
    },
    "floor": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "surface": {
      "description": "Living area in m²",
      "type": "number",
      "minimum": 1,
      "maximum": 1000
    },
    "complement": {
      "description": "e.g. 'Apt 12', 'Bât B'",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The dwelling of a French DPE (energy performance certificate) by its 13-character number (e.g. 2569E0160739C), with the same rental verdict as check_rental_compliance. Replaced DPEs are not available: the ADEME dataset drops them.

{
  "type": "object",
  "properties": {
    "dpe_number": {
      "type": "string"
    }
  },
  "required": [
    "dpe_number"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}