🇫🇷 BODACC Risk Monitor — French Company Legal Alerts

Monitor French companies for insolvency, liquidation, and legal events — in a single API call.

Search the official BODACC registry by SIREN and get back structured legal announcements with a computed risk score. Built for credit risk teams, compliance officers, procurement departments, and KYB workflows.

---

What is the BODACC?

The BODACC (Bulletin Officiel des Annonces Civiles et Commerciales) is the official French government journal that publishes every legal event affecting a registered company:

• Procédures collectives — court-ordered restructuring, receivership, liquidation
• Modifications — changes of directors, legal status, company name
• Ventes et cessions — business sales and transfers
• Radiations — company strikes from the trade register
• Créations — new company registrations
• Dépôts des comptes — annual financial statement filings

It is published daily by the DILA (Direction de l'information légale et administrative) and is the single source of truth for French corporate legal events.

---

Why use this Actor?

Manually checking the BODACC for a supplier, a customer, or an acquisition target is slow, error-prone, and impossible to scale. This Actor automates it.

• ✅ Official data source — DILA / BODACC, no scraping, no legal risk
• ✅ Risk score included — each announcement is classified from 1 (low) to 3 (critical)
• ✅ Batch processing — check hundreds of SIREN in a single run
• ✅ Clean, normalized output — no need to parse the raw BODACC feed
• ✅ Pay only for results — you are charged per announcement detected

---

Use cases

Use case	Who uses it	Example
Supplier risk monitoring	Procurement, Supply Chain	Detect a key supplier entering liquidation before it disrupts your operations
Customer credit risk	Finance, Credit Control	Flag customers filing for court-ordered restructuring
KYB / Compliance	Legal, Compliance	Verify the legal status of a business partner before onboarding
Due diligence	M&A, Private Equity	Build a legal history of a target company before an acquisition
Competitive intelligence	Strategy, Sales	Track director changes and ownership transfers at competitors
Portfolio monitoring	Banks, Insurers	Continuously monitor loan or policy holders for legal events

---

Input

Field	Type	Required	Description
sirens	array of strings	✅ Yes	List of SIREN numbers (9 digits) to monitor.
typesAnnonces	array of strings	No	Filter by announcement type. If empty or omitted, all types are returned.
dateDebut	string	No	Start date in YYYY-MM-DD format. If omitted, no date filter is applied.

Available announcement types

Value	Meaning	Risk level
procedure_collective	Court-ordered restructuring or liquidation	🔴 Critical
radiation	Company struck from the trade register	🔴 Critical
vente	Business sale or transfer	🟠 High
modification	Change of director, status, or name	🟢 Low
creation	New company registration	🟢 Low
dpc	Annual financial statements filed	🟢 Low

Example input

{
  "sirens": ["879685725", "552100554"],
  "typesAnnonces": ["procedure_collective", "modification"],
  "dateDebut": "2024-01-01"
}

Example input — all types, no date filter

{
  "sirens": ["879685725"]
}

---

Output

For each announcement found, the Actor pushes one record to the dataset.

Example output

{
  "siren": "879685725",
  "type_annonce": "collective",
  "type_annonce_libelle": "Procédures collectives",
  "date_publication": "2025-01-29",
  "tribunal": "Tribunal de commerce de Bordeaux",
  "ville": "Bordeaux",
  "commercant": "ALLEGRIA",
  "departement": "33",
  "gravite": 3,
  "url": "https://www.bodacc.fr/..."
}

Output fields

Field	Description
siren	The company's 9-digit identifier
type_annonce	Raw announcement family from the BODACC API
type_annonce_libelle	Human-readable French label
date_publication	Publication date of the announcement
tribunal	Court that issued the ruling (if applicable)
ville	City of the court or registered office
commercant	Name of the company or merchant concerned
departement	French department code
gravite	Computed risk score: 1 (low), 2 (medium), 3 (critical)
url	Link to the original announcement on bodacc.fr

If no announcement is found for a SIREN, it is skipped and an info log is emitted.

---

Pricing

This Actor uses Pay-Per-Event pricing:

Event	Price	Description
annonce_detectee	$10.00 / 1,000 announcements	Charged once per announcement detected and returned
actor_start	$0.00005	Standard Apify startup fee

You only pay for results. If a company has no legal announcements, you are not charged for it.

Example: monitoring 500 suppliers that generate 40 announcements per month costs $0.32 / month.

---

How to use it

1. Go to the Input tab.
2. Paste your list of SIREN numbers.
3. (Optional) Select the announcement types you want to monitor.
4. (Optional) Set a start date to limit results.
5. Click Start.
6. Download your results from the Dataset tab in JSON, CSV, or Excel format.

Programmatic access

You can call this Actor from your own code using the Apify API:

curl -X POST "https://api.apify.com/v2/acts/songful_laborer~bodacc-risk-monitor/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sirens": ["879685725"], "typesAnnonces": ["procedure_collective"]}'

Or with the Apify Python client:

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("songful_laborer/bodacc-risk-monitor").call(
    run_input={"sirens": ["879685725"], "typesAnnonces": ["procedure_collective"]}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

---

Where to find SIREN numbers

Every French company has a unique 9-digit SIREN identifier. You can find it:

• On any French invoice or official document
• On the annuaire-entreprises.data.gouv.fr website
• In your CRM, ERP, or supplier database

If you only have a company name, you can use the free government search at recherche-entreprises.api.gouv.fr to find its SIREN first.

---

Data source & legal notice

All data is retrieved from the official BODACC API published by the DILA (Direction de l'information légale et administrative):

https://www.bodacc.fr/pages/api-bodacc/

The BODACC is a public, official, and freely reusable data source under the French Licence Ouverte / Open Licence 2.0. Commercial reuse is explicitly permitted.

This Actor does not scrape any website and does not violate any Terms of Service. It is a clean, compliant wrapper around a public API.

---

Risk score methodology

The gravite field is computed by this Actor based on the announcement family:

• 3 (Critical) — procedure_collective, radiation, dpc These events indicate severe financial distress, court intervention, or full financial disclosure obligations.

• 2 (High) — vente A business sale or transfer may signal ownership change, financial difficulty, or strategic exit.

• 1 (Low) — modification, creation Routine corporate events with no immediate risk implication.

This scoring is indicative only and does not constitute financial or legal advice.

---

Limitations

• Data covers companies registered in France only (including DOM-TOM).
• The BODACC covers events from 2008 onwards. Older events are not available.
• Companies in Alsace-Moselle follow specific local registry rules that may affect some fields.
• Duplicate SIREN in the input are not deduplicated. If you provide the same SIREN twice, it will be queried twice.
• Very large batches (10,000+ SIREN) may take several minutes to complete due to API rate limits.

---

Support

Found a bug or have a feature request? Please open an issue in the Issues tab of this Actor, or contact me directly through the Apify platform.

If you find this Actor useful, a ⭐ review helps a lot!

---

Changelog

v1.0.0 — Initial release

• Monitor French companies by SIREN
• Retrieve legal announcements from the official BODACC API (Explore v2.1)
• Filter by announcement type and date range
• Computed risk score (gravite) from 1 to 3
• Pay-Per-Event monetization