# France Company Data & KYB - SIREN, SIRET, BODACC, Financials (`rejoicing_shanty/france-company-due-diligence`) Actor

French company lookup & due diligence from official SIRENE + BODACC data. Bulk SIREN/SIRET/VAT lookup or search by name, NAF, postcode: directors, revenue, insolvency & liquidation status, accounts filings, risk flags. Open-data alternative to Pappers / Societe.com for KYB, supplier checks, leads.

- **URL**: https://apify.com/rejoicing_shanty/france-company-due-diligence.md
- **Developed by:** [Bachir Djoukbala](https://apify.com/rejoicing_shanty) (community)
- **Categories:** Business, Lead generation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 company records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## France Company Data & KYB – SIREN, SIRET, BODACC & Financials

**French company lookup and due diligence in bulk, from official open data.** Give it SIREN, SIRET or French VAT numbers – or search French companies by name, NAF/APE code, postcode, department, size or revenue – and get one clean JSON record per company: official identity from the **SIRENE register** (INSEE / RNE), **directors (dirigeants)**, **intra-EU VAT number**, **revenue (chiffre d'affaires) and net income**, **BODACC insolvency proceedings** (safeguard, receivership, **liquidation judiciaire**) with their current status, **accounts filings**, **strike-off** and ready-made **risk flags**.

An open-data alternative to Pappers, Societe.com and Infogreffe lookups: built only on official sources (API Recherche d'entreprises by DINUM/INSEE/INPI and BODACC by DILA). No scraping of those sites, no login, no API key, no proxies. Export to JSON, CSV or Excel, or call it from the Apify API, Make, Zapier, n8n or an AI agent.

**Popular uses:**

- **KYB / AML onboarding** – verify a French customer, merchant or partner exists, is active and is not in liquidation.
- **Supplier checks (contrôle fournisseur)** – screen vendors for open insolvency proceedings, missing accounts filings and losses.
- **Lead enrichment and B2B lead lists** – add legal form, NAF code, headcount, revenue and directors to your CRM, or build lists by NAF code and location.

Works well alongside our [UK Companies House](https://apify.com/rejoicing_shanty/uk-company-due-diligence) Actor for UK + France coverage.

### What you get for each company

| Section | Fields |
|---|---|
| **Identity** | SIREN, head-office SIRET, intra-EU **VAT number**, legal name, acronym, trade names, status (Active / Ceased), creation and closure dates |
| **Legal form** | INSEE legal category code + label (SAS, SASU, SARL, EURL, SA, sole trader...) |
| **Activity** | NAF/APE code + official label, sector section, NAF 2025 code |
| **Size** | Company category (SME / mid-cap / large), employee band + reference year, number of establishments (total / open) |
| **Head office** | Address, postal code, city, department, region, GPS coordinates |
| **Directors** | Name, role (Président, Gérant, Administrateur, auditor...), birth year-month, or company directors with their SIREN |
| **Financials** | Revenue (chiffre d'affaires) and net income by year, when published |
| **BODACC** | Notice counts by type, **insolvency proceedings** with judgment, court, date and **current status** (open / plan / closed + liquidation / receivership / safeguard), accounts filings (year end, confidential or not), strike-off, latest notices with links |
| **Risk flags** | `isActive`, `inLiquidation`, `inOpenInsolvencyProceeding`, `inInsolvencyProceedings`, `hasInsolvencyHistory`, `struckOff`, `noAccountsFiledLast24Months`, `negativeNetIncome`, `revenueDecline`, `recentlyCreated`, `companyAgeYears`, overall **`riskLevel`** (low / medium / high) |
| **Labels** | ESS, RGE, Qualiopi, organic, Société à mission, EPV and other official labels |
| **Compliance** | `optedOutOfCommercialProspecting` - the company's official opt-out from commercial prospecting |

### Use cases

- **KYB / AML onboarding** - verify a French supplier, merchant or customer exists, is active and is not in liquidation.
- **Credit and counterparty risk** - spot open insolvency proceedings, missing accounts filings and losses before you extend credit.
- **Supplier and vendor monitoring** - schedule the Actor on your vendor list and alert on new BODACC proceedings.
- **VAT number lookup** - get the intra-EU VAT number from a SIREN, or the company from a VAT number.
- **Lead lists and market sizing** - search by NAF code, department, size or revenue band and export to CSV / Excel.
- **CRM enrichment** - add legal form, NAF, headcount, revenue and directors to your accounts.

### Input

Look up known companies, search, or both in one run.

```json
{
  "companyIds": ["552032534", "FR14652014051", "982 335 069 00011"],
  "searchQuery": "boulangerie",
  "postalCodes": ["28000"],
  "maxResults": 50,
  "includeBodacc": true,
  "maxBodaccNotices": 10
}
```

| Field | Description |
|---|---|
| `companyIds` | SIREN (9 digits), SIRET (14 digits) or French VAT numbers (FRxx + SIREN). Checksums are validated; invalid or unknown IDs return a **free** error record. |
| `searchQuery` | Free text across names, addresses and directors. |
| `nafCodes`, `postalCodes`, `departments`, `legalFormCodes`, `employeeBands`, `companyCategory`, `minRevenue`, `maxRevenue`, `directorName` | Search filters (all optional, combinable). |
| `activeOnly` | Search returns active companies only (default `true`). |
| `maxResults` | Cap on search results (default 50, max 5,000). |
| `includeBodacc` | Add BODACC notices, insolvency status and filings (default `true`). |
| `maxBodaccNotices`, `maxDirectors` | Output size controls. |

### Sample output

Real record (trimmed: 2 of 17 directors, 1 of 10 recent notices):

```json
{
  "input": "FR14652014051",
  "siren": "652014051",
  "siretHeadOffice": "65201405100732",
  "vatNumber": "FR14652014051",
  "name": "CARREFOUR",
  "status": "Active",
  "createdOn": "1963-01-01",
  "legalForm": { "code": "5599", "label": "SA à conseil d'administration (s.a.i.)" },
  "activity": { "nafCode": "64.20Z", "label": "Activités des sociétés holding", "section": "K", "sectionLabel": "Financial and insurance activities" },
  "companyCategory": "Large enterprise (GE)",
  "employees": { "bandCode": "02", "band": "3-5", "year": "2024" },
  "establishments": { "total": 7, "open": 1 },
  "headOffice": { "address": "93 AVENUE DE PARIS 91300 MASSY", "postalCode": "91300", "city": "MASSY", "department": "91", "region": "11", "latitude": 48.7235, "longitude": 2.2654 },
  "directors": [
    { "type": "person", "lastName": "BARRAULT", "firstNames": "FREDERIC JEAN-CLAUDE", "role": "Administrateurs représentant les salariés", "birthYearMonth": "1965-07" },
    { "type": "person", "lastName": "BERARD", "firstNames": "MARGUERITTE MARIE ALICE SIMONE", "role": "Administrateur", "birthYearMonth": "1977-12" }
  ],
  "directorsCount": 17,
  "financials": { "years": [ { "year": 2025, "revenue": 81149000000, "netIncome": 0 } ] },
  "optedOutOfCommercialProspecting": true,
  "bodacc": {
    "totalNotices": 243,
    "noticesByFamily": { "Accounts filing": 36, "Registration": 1, "Modification": 53, "Sale / transfer of business": 153 },
    "insolvency": { "currentStatus": null, "proceedings": [] },
    "lastAccountsFiling": { "publishedOn": "2026-08-21", "yearEnd": "2025-12-31", "type": "Comptes consolidés et rapports", "confidential": false },
    "strikeOff": null,
    "recentNotices": [
      { "publishedOn": "2026-08-21", "family": "Accounts filing", "summary": "Comptes consolidés et rapports (year end 2025-12-31)", "court": "Greffe du Tribunal de Commerce d'evry", "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:C202601595142" }
    ]
  },
  "flags": {
    "isActive": true, "recentlyCreated": false, "companyAgeYears": 63.9, "negativeNetIncome": false, "revenueDecline": false,
    "hasInsolvencyHistory": false, "inInsolvencyProceedings": false, "inOpenInsolvencyProceeding": false, "inLiquidation": false,
    "struckOff": false, "noAccountsFiledLast24Months": false, "riskLevel": "low"
  },
  "registerUrl": "https://annuaire-entreprises.data.gouv.fr/entreprise/652014051"
}
```

A company placed in liquidation looks like this (real BODACC notice published 2026-11-15, SIREN 979974656; excerpt):

```json
"insolvency": {
  "currentStatus": { "status": "open", "kind": "liquidation", "since": "2026-11-04", "judgment": "Jugement d'ouverture de liquidation judiciaire", "noLaterJudgmentForYears": 0.0, "possiblyStale": false },
  "proceedings": [ {
    "publishedOn": "2026-11-15", "judgmentDate": "2026-11-04", "type": "Jugement d'ouverture",
    "nature": "Jugement d'ouverture de liquidation judiciaire", "court": "Greffe du Tribunal de Commerce de Bordeaux",
    "details": "Jugement prononçant la liquidation judiciaire, date de cessation des paiements le 31 août 2026, désignant liquidateur SELARL Laura Lafon ...",
    "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:A202602191507"
  } ]
},
"lastAccountsFiling": { "publishedOn": "2025-10-03", "yearEnd": "2025-03-31", "type": "Comptes annuels et rapports", "confidential": true },
"flags": { "inLiquidation": true, "inOpenInsolvencyProceeding": true, "hasInsolvencyHistory": true, "riskLevel": "high" }
```

Error records (invalid SIREN, not found) contain only `input`, `error` and `retrievedAt`, and are **never charged**.

### Pricing (pay per event)

You pay only for companies successfully returned. Error records are free. Platform usage is included.

| Event | Price | Per 1,000 companies |
|---|---|---|
| Company record (registry, directors, financials, flags) - `includeBodacc: false` | **$0.003** | $3 |
| Company record **with BODACC** insolvency, filings and notices (default) | **$0.005** | $5 |

Set a maximum cost per run in the Apify Console and the Actor stops cleanly when it is reached.

### Data sources and limits

- **API Recherche d'entreprises** (recherche-entreprises.api.gouv.fr) - SIRENE (INSEE) and RNE (INPI) data, open licence. Companies that opted out of public dissemination (*non-diffusibles*) are not available and return a free "not found" record.
- **BODACC** (bodacc-datadila.opendatasoft.com, DILA) - Licence Ouverte 2.0.
- Revenue / net income are only available when the company published its accounts; many small companies file confidentially, so `financials.years` can be empty.
- The SIRENE status can lag behind court decisions. A company can still show `Active` while BODACC already shows a closed liquidation or strike-off, which is why the risk flags use both sources.
- `noAccountsFiledLast24Months` is based on BODACC accounts-filing notices and only applies to commercial companies (SA, SAS, SARL...) older than 2 years.
- Search returns up to 5,000 companies per run; split large extractions by department or NAF code.

### Legal and GDPR note

All data is official public register data published under open licences. Directors' names and birth year-month are published by the French registers for transparency. Process personal data only for a lawful purpose (KYB, AML, credit risk, B2B relations) and respect `optedOutOfCommercialProspecting` for marketing use. This Actor is not affiliated with INSEE, INPI, DINUM or DILA.

### FAQ

**Can I look up a company by VAT number?** Yes. Pass `FR` + 2-character key + SIREN (e.g. `FR14652014051`).

**Does it give UBOs (bénéficiaires effectifs)?** No. Public access to the French beneficial-ownership register has been restricted since the 2022 EU Court of Justice ruling.

**How fresh is the data?** Both sources are queried live at run time. SIRENE/RNE is updated daily; BODACC is published every working day.

**Can I monitor companies?** Yes. Schedule the Actor with your SIREN list and compare `flags` or `bodacc.insolvency.currentStatus` between runs.

# Actor input Schema

## `companyIds` (type: `array`):

French company identifiers to look up: SIREN (9 digits, e.g. 552032534), SIRET (14 digits) or French VAT number (e.g. FR27552032534). Spaces and dots are ignored. Invalid or unknown identifiers return a free error record instead of failing the run.

## `searchQuery` (type: `string`):

Optional free-text search across company names, addresses and directors (e.g. 'boulangerie lyon'). Can be combined with the filters below, or leave empty and use filters only.

## `nafCodes` (type: `array`):

Filter by INSEE NAF rev.2 activity code, format 00.00X (e.g. 62.01Z software development, 56.10A restaurants).

## `postalCodes` (type: `array`):

Filter by establishment postal code (5 digits, e.g. 75008).

## `departments` (type: `array`):

Filter by department code (e.g. 75, 69, 2A, 971).

## `legalFormCodes` (type: `array`):

Filter by INSEE legal category code (e.g. 5710 SAS, 5720 SASU, 5499 SARL, 5498 EURL, 5599 SA, 1000 sole trader).

## `companyCategory` (type: `string`):

PME = SME, ETI = mid-cap, GE = large enterprise.

## `employeeBands` (type: `array`):

INSEE headcount bands: 01=1-2, 02=3-5, 03=6-9, 11=10-19, 12=20-49, 21=50-99, 22=100-199, 31=200-249, 32=250-499, 41=500-999, 42=1000-1999, 51=2000-4999, 52=5000-9999, 53=10000+.

## `minRevenue` (type: `integer`):

Only companies whose latest published revenue is at least this amount.

## `maxRevenue` (type: `integer`):

Only companies whose latest published revenue is at most this amount.

## `directorName` (type: `string`):

Find companies where a person with this last name is a director (dirigeant).

## `activeOnly` (type: `boolean`):

When searching, return only companies that are still active. Direct SIREN lookups always return the company whatever its status.

## `maxResults` (type: `integer`):

Maximum companies returned by the search (direct identifier lookups are not limited by this).

## `includeBodacc` (type: `boolean`):

Add official BODACC notices: insolvency proceedings (safeguard, receivership, liquidation) with current status, accounts filings, strike-off and recent notices. Recommended for due diligence; priced as a 'with BODACC' record.

## `maxBodaccNotices` (type: `integer`):

How many of the most recent BODACC notices to list per company (insolvency proceedings and accounts filings are always summarised separately).

## `maxDirectors` (type: `integer`):

Maximum directors / officers returned per company.

## Actor input object example

```json
{
  "companyIds": [
    "552032534",
    "FR14652014051"
  ],
  "activeOnly": true,
  "maxResults": 50,
  "includeBodacc": true,
  "maxBodaccNotices": 10,
  "maxDirectors": 30
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "companyIds": [
        "552032534",
        "FR14652014051"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("rejoicing_shanty/france-company-due-diligence").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "companyIds": [
        "552032534",
        "FR14652014051",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("rejoicing_shanty/france-company-due-diligence").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "companyIds": [
    "552032534",
    "FR14652014051"
  ]
}' |
apify call rejoicing_shanty/france-company-due-diligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rejoicing_shanty/france-company-due-diligence"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/5fAgZfkcfgf5PM4ye/builds/q2pkutTqOYmhcSo7E/openapi.json
