French insolvency records API for AI agents
Know when a French counterparty gets into legal trouble: this endpoint returns the legal announcements published for one company in the BODACC, France's official gazette for commercial notices (DILA open data, new announcements published daily). Queried by SIREN, it lists newest-first insolvency proceedings, business sales, deregistrations and annual-accounts deposits, each with family, tribunal, judgment nature and date, and a link to the announcement on bodacc.fr.
It is built for autonomous agents: no account, no API key - the agent pays $0.01 per call in USDC. Results cover legal entities only (announcements about natural persons are filtered out, GDPR), and zero announcements for a valid SIREN is itself a useful clean-record signal. Invalid SIRENs are rejected with a 400 and never billed.
Endpoint
GET /v1/fr/bodacc — $0.01 per call (USDC on Base, x402). Also available as the MCP tool check_insolvency_fr on https://data.greeneris.io/mcp.
Parameters
| Param | Description |
|---|---|
siren | 9-digit French SIREN company id (required, Luhn-validated), e.g. 383474814 |
famille | Optional family filter: collective (= insolvency proceedings), conciliation, creation, divers, dpc, immatriculation, modification, radiation, retablissement_professionnel, vente |
limit | Max announcements, 1-20 (default 10) |
Example
curl -i "https://data.greeneris.io/v1/fr/bodacc?siren=383474814&limit=5"
# HTTP/1.1 402 Payment Required + machine-readable quote
# (any x402 client pays the quote and retries automatically)Response after payment:
{"ok": true, "data": {"siren": "383474814", "famille": null, "total_count": 47, "count": 2, "announcements": [{"id": "C202600982530", "date": "2026-05-26", "family": "Dépôts des comptes", "family_code": "dpc", "type": "Avis initial", "company": "AIRBUS", "legal_form": "Société par actions simplifiée", "tribunal": "Greffe du Tribunal de Commerce de toulouse", "city": "Blagnac", "judgment": null, "deposit": {"type": "Comptes annuels et rapports", "closing_date": "2025-12-31"}, "url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:C202600982530"}]}}What agents use it for
- Credit-risk screening: query famille=collective before extending payment terms to detect open insolvency proceedings
- Supplier monitoring: re-check a SIREN periodically and alert on new judgments, sales or deregistrations
- KYB files: attach tribunal history and the latest annual-accounts deposit to a company record
How payment works
Call the endpoint: you get HTTP 402 with a signed quote (price, receiving address, network). Your agent pays a few tenths of a cent in USDC on Base (gasless, EIP-3009) and retries - one round trip, no account, no API key. Settlement only happens after a successful answer. Full catalog: llms.txt.