REST · JSON · v1

Public API

JSON endpoints over the Checked data. X-Api-Key required, rate-limited at 60 req/min per IP. Key + bulk + SLA: enterprise@checked.be

Base

Base URL	https://checked.be/api/v1
Format	JSON, snake_case
Authentication	`X-Api-Key` header (required)
Rate limit	60 req/min per IP
CORS	Open
Versionering	URL path (`/v1/`)

Authentication

X-Api-Key

Every /api/v1 call requires an X-Api-Key header. Request a key via enterprise@checked.be. Calls without a valid key receive HTTP 401.

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

GET /companies/{kbo}

Full dossier

Returns risk, rollup, address, mandates and NACE for one KBO (10 digits, no dots).

$ 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}

Search by name, VAT or 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 timeline

Complete Belgisch Staatsblad timeline.

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

GET /companies/{kbo}/rollup

Aggregates

Compact aggregate: counts + has_open_faillissement + first/last signal dates.

$ 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 of the deployed build
GET /sitemap.xml	Hreflang-aware sitemap

Enterprise volumes?

Bulk endpoints, higher rate limits, SLA and custom data feeds available.

enterprise@checked.be