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 base | https://checked.be/api/v1 |
| Format | JSON, snake_case |
| Authentification | X-Api-Key header (requis) |
| Rate limit | 60 req/min par IP |
| CORS | Ouvert |
| Versionering | URL path (/v1/) |
Authentification
X-Api-KeyChaque 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 completRenvoie 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}
RechercheRecherche 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 MBChronologie complète Moniteur belge.
$ curl -H "X-Api-Key: jouw-sleutel" https://checked.be/api/v1/companies/0681493591/lifecycle
GET /companies/{kbo}/rollup
AgrégatsAgré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 /healthz | Sondes base de données + sources |
| GET /version | Hash de commit déployé |
| GET /sitemap.xml | Sitemap hreflang |
Volumes enterprise ?
Endpoints bulk, limites élevées, SLA et flux personnalisés disponibles.