Is the BODACC API free?

Yes, the BODACC API is free and open on public data: notices, companies, people, directory and statistics, with no key and no subscription. Pro and Enterprise plans add API keys and priority access.

Do I need an API key?

No, public access requires no key. API keys (prefix sk_bodacc_) are provided with Pro and Enterprise plans for the endpoints that require them, from My account then API.

What are the API limits?

limit is capped at 500 results per request and offset at 10 000. The directory is limited to 200 pages of 100. On 429, respect the Retry-After header.

Is the data real time?

Yes, notices are exposed as soon as they are published in BODACC, where the historical file is downloaded only once a day.

BODACC API quickstart : BODACC.io : legal notices

Open data, free and real time

The BODACC API is free and open: it provides real-time open data access to the full Official Bulletin database — 11.3 million notices, 6.7 million companies, 1.9 million people (live figures from stats/counts). While the historical BODACC file is downloaded once a day, the API exposes notices as soon as they are published, with no key required for public data.

# Exact counters, no key
curl "https://bodacc.io/api/bodacc/stats/counts"

First call

The public BODACC API is accessible without a key for data. The most used endpoint searches notices by keyword:

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

Response (excerpt):

{
  "total": 48231,
  "results": [
    {
      "id": "A2023001_000123",
      "dateparution": "2026-08-07",
      "typeavis": "A",
      "familleavis": "creation",
      "commercant": "BOULANGERIE DUPONT",
      "ville": "LYON",
      "numerodepartement": "69"
    }
  ],
  "limit": 5,
  "offset": 0
}

Full specification

The API documents 46 endpoints (verified on the live OpenAPI). Two ways to explore them:

Swagger UI: https://bodacc.io/api/bodacc/docs
https://bodacc.io/api/bodacc/openapi.json

Main endpoints

Endpoint	Description
`GET /api/bodacc/annonces`	Search notices (keyword, family, city, department, SIREN, dates)
`GET /api/bodacc/annonces/{id}`	Notice detail + relations (company, people)
`GET /api/bodacc/entreprises`	Search companies (name, SIREN, NAF, status, enriched filters)
`GET /api/bodacc/entreprises/{siren}`	Full SIREN record
`GET /api/bodacc/personnes/{id}`	Person record (identity + mandates)
`GET /api/bodacc/annuaire/{role}`	Directory of liquidators, trustees, administrators
`GET /api/bodacc/stats/counts`	Global counters (notices, companies, people)

Authentication

Public access requires no key. For Pro and Enterprise plans, documented endpoints accept an API key:

curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie" \
  -H "X-API-Key: sk_bodacc_..."

The key can also be passed as Authorization: Bearer sk_bodacc_.... An invalid or revoked key returns 401.

Errors

The API returns standard HTTP errors with a JSON body describing the issue:

400: invalid parameter
401: invalid or revoked API key
404: resource not found
429: too many requests — respect the Retry-After header

Limits

limit: between 1 and 500 per request
offset: up to 10 000 (anti-dump pagination)
Data is updated in real time after each BODACC publication
Family searches use exact materialized totals (total_estime absent); combined text searches may return an estimated total ("total_estime": true)

Go further

Search notices: all search parameters
Company records: search and SIREN record
People and directory: directors and professionals
Statistics: counters and series
Authentication and limits: API keys and best practices

BODACC API quickstart