How do I filter notices by SIREN?

Pass the siren=123456789 parameter: the API queries the notice registry via the GIN index and returns all notices linked to that SIREN, without relying on the business name.

What is the result limit per request?

limit accepts between 1 and 500, default 20. Pagination deliberately stops at 10 000 cumulative results (offset) to prevent full database dumps.

How do I filter by family or period?

Use famille=creation, vente, modification, radiation, collective, dpc... and date_debut/date_fin in ISO format (YYYY-MM-DD).

What does total_estime mean?

Simple filters (family, department) use exact materialized totals. Combined text searches return a total estimated by the PostgreSQL planner, flagged with total_estime set to true.

Search BODACC notices : BODACC.io

Search notices

The GET /api/bodacc/annonces endpoint queries the French Official Bulletin of Civil and Commercial Notices: creations, sales, modifications, radiations, collective proceedings and annual accounts filings, in real time after each publication.

curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"

Search parameters

Parameter	Description	Example
`q`	Keyword in the business name or city	`q=dupont`
`typeavis`	Notice type	`typeavis=A` (creation)
`famille`	Notice family	`famille=liquidation`
`departement`	Department code	`departement=33`
`ville`	City (accent-insensitive)	`ville=LYON`
`date_debut`	Published from (ISO)	`date_debut=2026-07-01`
`date_fin`	Published until (ISO)	`date_fin=2026-07-31`
`siren`	Filter by SIREN (registry)	`siren=123456789`
`limit`	Number of results (1 to 500)	`limit=50`
`offset`	Pagination (0 to 10 000)	`offset=50`

Notice families

Main families: creation, immatriculation, vente, modification, radiation, collective (collective proceedings), conciliation, retablissement, dpc (annual accounts), divers.

# Liquidations this month in department 33
curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=33&date_debut=2026-07-01&limit=20"

Pagination and limits

limit: between 1 and 500 per request (default 20)
offset: up to 10 000 — beyond that, results are deliberately truncated (anti-dump)
The total field gives the total number of results; total_estime: true flags an estimate from the PostgreSQL planner (combined text searches) — simple filters (family, department) use exact materialized totals

Reading a response

Each result contains: id, dateparution, numeroannonce, typeavis, typeavis_lib, familleavis, familleavis_lib, numerodepartement, departement_nom_officiel, commercant, ville, cp, tribunal, slug, registre.

Full notice detail (with company and people relations) is available via GET /api/bodacc/annonces/{id}:

curl "https://bodacc.io/api/bodacc/annonces/A2023001_000123"

Complete example

Search for business radiations in Bordeaux over the last 30 days:

curl "https://bodacc.io/api/bodacc/annonces?famille=radiation&ville=bordeaux&date_debut=2026-07-08&limit=50"

Go further

Quickstart: first call and errors
Company records: from notice to SIREN record
Authentication and limits: API keys and quotas

Search BODACC notices