Is de BODACC-API gratis?

Ja, de BODACC-API is gratis en open voor de openbare data: aankondigingen, bedrijven, personen, register en statistieken, zonder sleutel en zonder abonnement. De Pro- en Enterprise-abonnementen voegen API-sleutels en geprioriteerde toegangen toe.

Heb ik een API-sleutel nodig?

Nee, de openbare toegang vereist geen sleutel. API-sleutels (voorvoegsel sk_bodacc_) worden geleverd met de Pro- en Enterprise-abonnementen voor de endpoints die dit vereisen, via Mijn account en dan API.

Wat zijn de API-limieten?

limit is begrensd op 500 resultaten per aanvraag en offset op 10 000. Het register is beperkt tot 200 pagina's van 100. Bij een 429 respecteert u de Retry-After-header.

Zijn de gegevens realtime?

Ja, de aankondigingen worden getoond zodra ze in de BODACC verschijnen, terwijl het historische bestand slechts één keer per dag wordt gedownload.

Snelstart BODACC API : BODACC.io

Open data en gratis

De BODACC API is gratis en open: deze biedt via open data en in realtime toegang tot de volledige database van het Bulletin Officiel — 11,3 miljoen aankondigingen, 6,7 miljoen bedrijven, 1,9 miljoen personen (live cijfers stats/counts). Waar het historische BODACC-bestand één keer per dag wordt gedownload, toont de API de aankondigingen direct na publicatie, zonder sleutel voor openbare gegevens.

# De exacte tellers, zonder sleutel
curl "https://bodacc.io/api/bodacc/stats/counts"

Eerste aanroep

De openbare BODACC API is zonder sleutel toegankelijk voor de gegevens. Het meest gebruikte endpoint zoekt aankondigingen op trefwoord:

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

Antwoord (uittreksel):

{
  "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
}

Volledige specificatie

De API documenteert 46 endpoints (geverifieerd op de live OpenAPI). Twee manieren om deze te verkennen:

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

Belangrijkste endpoints

Endpoint	Beschrijving
`GET /api/bodacc/annonces`	Zoeken naar aankondigingen (trefwoord, familie, stad, departement, SIREN, datums)
`GET /api/bodacc/annonces/{id}`	Detail van een aankondiging + relaties (bedrijf, personen)
`GET /api/bodacc/entreprises`	Zoeken naar bedrijven (naam, SIREN, NAF, status, verrijkte filters)
`GET /api/bodacc/entreprises/{siren}`	Volledig dossier van een SIREN
`GET /api/bodacc/personnes/{id}`	Personenfiche (identiteit + mandaten)
`GET /api/bodacc/annuaire/{role}`	Register van vereffenaars, mandatarissen, bestuurders
`GET /api/bodacc/stats/counts`	Globale tellers (aankondigingen, bedrijven, personen)

Authenticatie

Voor openbare toegang is geen sleutel vereist. Voor de Pro- en Enterprise-aanbiedingen accepteren de gedocumenteerde endpoints een API-sleutel:

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

De sleutel kan ook worden doorgegeven via Authorization: Bearer sk_bodacc_.... Een ongeldige of ingetrokken sleutel retourneert 401.

Fouten

De API retourneert standaard HTTP-fouten met een JSON-body die het probleem beschrijft:

400: ongeldige parameter
401: ongeldige of ingetrokken API-sleutel
404: resource niet gevonden
429: te veel verzoeken — respecteer de Retry-After-header

Limieten

limit: tussen 1 en 500 per verzoek
offset: tot 10.000 (anti-dump paginering)
De gegevens worden in realtime bijgewerkt na elke publicatie van het BODACC
Zoeken op familie gebruikt exacte gematerialiseerde totalen (total_estime afwezig); gecombineerde tekstzoekopdrachten kunnen een geschat totaal retourneren ("total_estime": true)

Verder lezen

Aankondigingen zoeken: alle zoekparameters
Bedrijfsfiches: zoeken en SIREN-fiche
Personen en register: bestuurders en professionals
Statistieken: tellers en reeksen
Authenticatie en limieten: API-sleutels en goede praktijken

Snelstart BODACC API