Aller au contenu
REST · JSON · v1

API publique

Endpoints JSON, clé X-Api-Key requise, limités à 60 req/min par IP. Clé + bulk + SLA : enterprise@checked.be


Base
URL de basehttps://checked.be/api/v1
FormatJSON, snake_case
AuthentificationX-Api-Key header (requis)
Rate limit60 req/min par IP
CORSOuvert
VersioneringURL path (/v1/)

Authentification
X-Api-Key

Chaque appel /api/v1 requiert un en-tête X-Api-Key. Demandez une clé via enterprise@checked.be. Les appels sans clé valide reçoivent HTTP 401.

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

GET /companies/{kbo}
Dossier complet

Renvoie risk, rollup, adresse, mandats et NACE pour un numéro BCE (10 chiffres).

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

Recherche par nom, TVA ou BCE. Limite par défaut 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
Chronologie MB

Chronologie complète Moniteur belge.

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

GET /companies/{kbo}/rollup
Agrégats

Agrégat compact : compteurs + has_open_faillissement + premier/dernier signal.

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

Statut & observability
GET /healthzSondes base de données + sources
GET /versionHash de commit déployé
GET /sitemap.xmlSitemap hreflang

Volumes enterprise ?
Endpoints bulk, limites élevées, SLA et flux personnalisés disponibles.
enterprise@checked.be