French Company Announcements by SIREN: Accounts, Sales, Insolvency (BODACC)
bodacc/search-announcements
Looks up the announcements the BODACC, the French official bulletin of civil and commercial announcements, has published about one company, found by its 9-digit SIREN registry number: filings of annual accounts, sales of a business, insolvency and liquidation proceedings, registry changes. Newest first, as published, each with its publication date, notice type, department and region, court registry, company name, town, registry number and, by type, the judgment, deposit or act details. Lookup by SIREN only: there is no search by name, and 000000000 is refused. Returns up to 100 announcements per call (default 20) with the total count; page with offset. An unknown SIREN returns a total of 0, not an error. Personal data: for a sole trader the company name is the person's name, and the record can carry their surname, first name, home address, trade and insolvency details; reuse must respect the GDPR. Source: DILA, BODACC, under the Etalab Licence Ouverte 2.0, served by Eden Engine; not an official DILA or BODACC product.
Price
$0.0026 per call
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.
Data source
Source: Direction de l'information légale et administrative (DILA), BODACC (Bulletin officiel des annonces civiles et commerciales), https://bodacc-datadila.opendatasoft.com, licence Etalab 2.0; each announcement carries its publication date (dateparution). Some records name sole traders: personal data, reuse must respect the GDPR. Served by Eden Engine; not an official DILA or BODACC product.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "bodacc/search-announcements" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "bodacc/search-announcements" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "bodacc/search-announcements", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "bodacc/search-announcements", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0026 |
- Updated
- Oct 20, 2026
Input and output schemas
Input schema
{
"type": "object",
"required": [
"siren"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "How many announcements to return, 1 to 100. Defaults to 20."
},
"siren": {
"type": "string",
"pattern": "^(?!0{9}$)[0-9]{9}$",
"description": "The company's 9-digit SIREN registry number, digits only, for example 752461681. 000000000 is refused."
},
"offset": {
"type": "integer",
"maximum": 9900,
"minimum": 0,
"description": "How many announcements to skip, for the next page. Defaults to 0. The offset plus the limit cannot exceed 10000."
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"required": [
"total_count",
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cp": {
"type": "string",
"description": "Postal code."
},
"id": {
"type": "string",
"description": "Announcement id, for example C202500182618."
},
"depot": {
"type": [
"string",
"null"
],
"description": "Details of a filing of accounts, as a JSON document in a string."
},
"ville": {
"type": "string"
},
"parution": {
"type": "string",
"description": "Bulletin number."
},
"registre": {
"type": "array",
"items": {
"type": "string"
},
"description": "Company registry number, plain and with spaces."
},
"tribunal": {
"type": "string",
"description": "The court registry that published it."
},
"typeavis": {
"type": "string",
"description": "Notice type code, for example annonce."
},
"commercant": {
"type": "string",
"description": "Company name, or a sole trader's name (personal data)."
},
"familleavis": {
"type": "string",
"description": "Announcement family code."
},
"region_code": {
"type": "integer"
},
"dateparution": {
"type": "string",
"description": "Publication date, YYYY-MM-DD."
},
"typeavis_lib": {
"type": "string",
"description": "Notice type label, in French."
},
"url_complete": {
"type": "string",
"description": "Link to the announcement on the BODACC site."
},
"numeroannonce": {
"type": "integer",
"description": "Number within the bulletin."
},
"listepersonnes": {
"type": [
"string",
"null"
],
"description": "The parties as a JSON document carried in a string."
},
"familleavis_lib": {
"type": "string",
"description": "Announcement family label, in French, for example deposits of accounts."
},
"publicationavis": {
"type": "string",
"description": "Bulletin series letter."
},
"numerodepartement": {
"type": "string"
},
"region_nom_officiel": {
"type": "string"
},
"departement_nom_officiel": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "The announcements of this page, as the register publishes them."
},
"total_count": {
"type": "integer",
"description": "How many announcements match the request in all, not only on this page."
}
},
"description": "One page of announcements and the total number of announcements matching the request.",
"additionalProperties": true
}