Documentation API

KBO Connect API

Tout ce dont vous avez besoin pour vous intégrer avec l'API KBO Connect.

Langue de la réponse:
Obtenir l'accès APIVoir les endpoints
API BatchDémarrage rapideAuthentificationEndpointsExemples de codeEn-têtes de quota

API Batch

Enterprise

Recherchez jusqu'à 50 entreprises ou établissements dans un seul appel POST. Conçu pour l'enrichissement CRM en masse, les pipelines KYC et la synchronisation nocturne. Les numéros inconnus sont omis silencieusement — vous recevez toujours un résultat partiel.

JavaScript
// POST /v1/companies/batch
const response = await fetch(
  'https://api.kboconnect.be/v1/companies/batch',
  {
    method: 'POST',
    headers,
    body: JSON.stringify([
      "0123456789",
      "0987654321",
      "0456789123"
    ])
  }
);


const companies = await response.json();
// Response: array of matching companies
[
  {
    "enterprise_number": "0123.456.789",
    "denomination": { "nl": "Voorbeeld NV" },
    "status": "active",
    "address": { "city": "Brussel" }
  }
  // ... meer resultaten
]

POST /establishments/batch fonctionne de la même manière avec les numéros d'établissement.

Authentification

L'API KBO Connect utilise l'authentification par jeton Bearer. Ajoutez votre clé API à l'en-tête Authorization de chaque requête.

JavaScript
// Authentication header
const headers = {
  'Authorization': 'Bearer your_api_key',
  'Content-Type': 'application/json',
  'Accept-Language': 'nl'
};

Première requête

Effectuez votre premier appel API pour récupérer les données d'une entreprise à partir de son numéro d'entreprise. Le format peut être avec ou sans points.

cURL
curl -X GET "https://api.kboconnect.be/v1/enterprises/0123456789" \
  -H "Authorization: Bearer your_api_key" \
  -H "Accept-Language: nl"
JavaScript + Response
// GET /v1/enterprises/0123456789
const response = await fetch(
  'https://api.kboconnect.be/v1/enterprises/0123456789',
  { headers }
);


const company = await response.json();
// Response:
{
  "enterprise_number": "0123.456.789",
  "denomination": {
    "nl": "Voorbeeld NV"
  },
  "status": "active",
  "juridical_form": {
    "code": "014",
    "description": "Naamloze vennootschap"
  },
  "address": {
    "street": "Koningsstraat",
    "house_number": "123",
    "postal_code": "1000",
    "city": "Brussel"
  },
  "activities": [
    {
      "nace_code": "62010",
      "description": "Computerprogrammering"
    }
  ]
}

Endpoints

Aperçu de tous les endpoints API disponibles. Cliquez sur un endpoint pour plus de détails.

GET/v1/enterprises/{enterprise_number}Récupérer les données d'une entreprise par numéro d'entreprise
GET/v1/enterprises/searchRechercher des entreprises par nom, adresse ou code NACE
GET/v1/establishments/{establishment_number}Récupérer les données d'un établissement par numéro d'établissement
GET/v1/enterprises/{enterprise_number}/branchesLister tous les établissements d'une entreprise
GET/v1/nace-codesLister tous les codes NACE disponibles avec leurs descriptions
POST/v1/companies/batchAPI Batch
POST/v1/establishments/batchAPI Batch

Recherche et filtrage

L'endpoint de recherche prend en charge différents paramètres de requête pour filtrer les résultats.

ParamètreTypeDescription
qstringTerme de recherche pour le nom d'entreprise
citystringFiltrer par ville
postal_codestringFiltrer par code postal
nace_codestringFiltrer par code d'activité NACE
statusstringactive, inactive, all
pageintegerNuméro de page (défaut : 1)
limitintegerRésultats par page (max : 100)
Exemple de recherche
// GET /v1/enterprises/search?q=software&city=Brussel
const response = await fetch(
  'https://api.kboconnect.be/v1/enterprises/search?' +
  'q=software&city=Brussel&limit=10',
  { headers }
);


const results = await response.json();
// Response:
{
  "total": 245,
  "page": 1,
  "limit": 10,
  "enterprises": [
    {
      "enterprise_number": "0123.456.789",
      "denomination": "Voorbeeld Software NV",
      "city": "Brussel",
      "nace_code": "62010"
    },
    // ... meer resultaten
  ]
}

Surveiller votre quota par programmation

Chaque réponse API authentifiée contient quatre en-têtes de réponse que vous pouvez lire par programmation — sans visiter le tableau de bord.

En-têteDescription
X-Monthly-LimitVotre limite mensuelle totale d'appels API pour l'abonnement actuel
X-Monthly-UsedNombre d'appels API consommés dans la période de facturation actuelle
X-Monthly-RemainingAppels restants — max(0, limite − utilisés)
X-Quota-WarningDéfini sur "true" lorsque vous approchez de votre limite mensuelle
Lecture des en-têtes de quota
// Reading quota headers from any API response
const res = await fetch(
  'https://api.kboconnect.be/v1/enterprises/0123456789',
  { headers }
);


const limit     = parseInt(res.headers.get('X-Monthly-Limit'));
const used      = parseInt(res.headers.get('X-Monthly-Used'));
const remaining = parseInt(res.headers.get('X-Monthly-Remaining'));
const warning   = res.headers.get('X-Quota-Warning') === 'true';


if (warning) {
  console.warn(`⚠ Low quota: ${remaining} of ${limit} calls remaining`);
}

Terrain de jeu API

Essayez l'API KBO Connect directement depuis votre navigateur avec votre propre clé API.

Questions fréquemment posées