REST · JSON · v1

Publieke API

JSON-endpoints over de Checked-data. X-Api-Key vereist, rate-limited op 60 req/min per IP. Sleutel + bulk + SLA: enterprise@checked.be

Basis

Basis-URL	https://checked.be/api/v1
Formaat	JSON, snake_case
Authenticatie	`X-Api-Key` header (verplicht)
Rate limit	60 req/min per IP
CORS	Open
Versionering	URL path (`/v1/`)

Authenticatie

X-Api-Key

Elke /api/v1-call vereist een X-Api-Key header. Vraag een sleutel aan via enterprise@checked.be. Calls zonder geldige sleutel krijgen HTTP 401.

$ curl -H "X-Api-Key: jouw-sleutel" https://checked.be/api/v1/companies/0400378485

GET /companies/{kbo}

Volledig dossier

Levert risk, rollup, adres, mandaten en NACE voor één KBO (10 cijfers, geen punten).

$ curl -H "X-Api-Key: jouw-sleutel" https://checked.be/api/v1/companies/0400378485
{
  "enterprise_number": "0400378485",
  "legal_name": "Colruyt Group",
  "primary_nace": "47110",
  "status": "active",
  "address": { "street": "Edingensesteenweg 196", "zip": "1500", "city": "Halle" },
  "risk": { "band": "Unknown", "score_out_of100": 0 },
  "rollup": null,
  "insolvency_event_count": 0,
  "admin_event_count": 0,
  "mandates": []
}

GET /search?q={query}

Bedrijven zoeken

Zoek op naam, BTW of KBO. Default limit 20, max 50.

$ curl -H "X-Api-Key: jouw-sleutel" 'https://checked.be/api/v1/search?q=colruyt&limit=5'
[
  { "enterprise_number": "0400378485", "legal_name": "Colruyt Group", "slug": "colruyt-group-0400378485", "city": "Halle", "primary_nace": "47110" },
  ...
]

GET /companies/{kbo}/lifecycle

BS-tijdlijn

Volledige Belgisch Staatsblad-tijdlijn: faillissementen, reorganisaties, voorlopig bewind, KBO admin events.

$ curl -H "X-Api-Key: jouw-sleutel" https://checked.be/api/v1/companies/0681493591/lifecycle

GET /companies/{kbo}/rollup

Aggregaten

Compact aggregaat: tellingen + has_open_faillissement + eerste/laatste signaaldatum.

$ curl -H "X-Api-Key: jouw-sleutel" https://checked.be/api/v1/companies/0681493591/rollup
{
  "total_events": 3,
  "interim_signals": 1,
  "reorg_events": 1,
  "faillissement_events": 1,
  "first_signal_date": "2026-01-05",
  "last_signal_date": "2026-05-20",
  "has_open_faillissement": true
}

Status & observability

GET /healthz	Database + data-source probes
GET /version	Commit-hash van de gedeploy'd build
GET /sitemap.xml	Hreflang-aware sitemap

Enterprise-volumes nodig?

Bulk-endpoints, hogere rate limits, SLA en custom datafeeds beschikbaar.

enterprise@checked.be