What does the full SIREN record give?

GET /entreprises/{siren} returns the identity, INSEE address, NAF code, directors, status (active or ceased) and linked notices.

How do I filter enriched companies?

avec_site, avec_email, avec_tel, avec_reseaux, avec_dirigeants and site_verifie filter on enrichment; the ess, siae, bio, rge and qualiopi labels on the social and solidarity economy.

Can I filter by department or postal code?

Yes: departement=33 filters on the first 2 digits of the postal code, code_postal=33000 on the start of the head office postal code.

BODACC API : company records : BODACC.io

Q: How do I find a company by SIREN?

The q=123456789 parameter (exactly 9 digits) is detected automatically and handled with indexed equality: instant response, even with a SIREN formatted with spaces or dots.

Search a company

The GET /api/bodacc/entreprises endpoint queries the database of over 6 million French companies built from legal notices and the registry.

# By name
curl "https://bodacc.io/api/bodacc/entreprises?q=boulangerie&limit=5"

An exact 9-digit SIREN is detected automatically and handled with indexed equality (instant response):

curl "https://bodacc.io/api/bodacc/entreprises?q=123456789"

Filter the search

Parameter	Description
`q`	Name or exact SIREN (9 digits)
`ville`	Head office city
`naf`	NAF code (code prefix)
`departement`	Department code (first 2 digits of the postal code)
`code_postal`	Postal code prefix
`etat`	`A` (active) or `C` (ceased)
`categorie`	Size (PME, ETI, GE...)
`tranche`	Employee size band
`forme`	Legal form
`dmin` / `dmax`	Creation date min/max
`fmin` / `fmax`	Closure date min/max

# Active companies in department 33 with a website
curl "https://bodacc.io/api/bodacc/entreprises?departement=33&etat=A&avec_site=true&limit=20"

Enriched criteria

Enrichment (data.gouv.fr, official website, networks) enables precise targeting:

avec_site: has a verified website
avec_email: known public email
avec_tel: known public phone
avec_reseaux: known social networks
avec_dirigeants: identified directors
site_verifie: website verified as official

Social and solidarity economy labels are filterable: ess, siae, bio, rge, qualiopi.

Full SIREN record

GET /api/bodacc/entreprises/{siren} returns the detailed record: identity, INSEE address, NAF, directors, and linked notices.

curl "https://bodacc.io/api/bodacc/entreprises/123456789"

A company's notices are paginated via GET /api/bodacc/entreprises/{siren}/annonces, and the readable slug resolves via /api/bodacc/entreprises/by-slug/{slug}.

Example

Find all organic companies in a department with directors:

curl "https://bodacc.io/api/bodacc/entreprises?departement=33&bio=true&avec_dirigeants=true&limit=50"

Go further

Quickstart: first call
Search notices: from a SIREN to its notices
People and directory: the directors behind the companies

BODACC API : company records