Documentation de l'API Kompaz

Démarrage

1. 1. Créer un compte gratuit Inscrivez-vous en ligne avec votre e-mail : la clé d'API reçue est la même que pour les autres services Nubelo. Sans clé, l'API répond quand même, avec un débit réduit, pour essayer.
2. 2. Interroger un numéro Un SIREN (9 chiffres) pour une entreprise, un SIRET (14 chiffres) pour un établissement, avec votre clé dans l'en-tête X-API-Key.
3. 3. Lire l'état etat indique si l'entreprise est active (A) ou cessée (C) ; l'adresse du siège est dans etablissements.

curl https://api.nubelo.fr/v1/entreprises/356000000 \
  -H "X-API-Key: VOTRE_CLE"

// Côté serveur (Node.js 18 ou plus) : la clé ne doit pas être envoyée au navigateur.
const reponse = await fetch("https://api.nubelo.fr/v1/entreprises/356000000", {
  headers: { "X-API-Key": process.env.KOMPAZ_CLE },
});
const entreprise = await reponse.json();
console.log(entreprise.denomination, entreprise.etat);

import os
import requests

reponse = requests.get(
    "https://api.nubelo.fr/v1/entreprises/356000000",
    headers={"X-API-Key": os.environ["KOMPAZ_CLE"]},
    timeout=10,
)
reponse.raise_for_status()
entreprise = reponse.json()
print(entreprise["denomination"], entreprise["etat"])

<?php
$ch = curl_init("https://api.nubelo.fr/v1/entreprises/356000000");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("KOMPAZ_CLE")],
]);
$entreprise = json_decode(curl_exec($ch), true);
echo $entreprise["denomination"], " ", $entreprise["etat"];

Réponse (extrait : un seul des établissements)

{
  "siren": "356000000",
  "denomination": "LA POSTE",
  "categorie_juridique": "5510",
  "activite_principale": "53.10Z",
  "etat": "A",
  "date_creation": "1991-01-01",
  "date_dernier_changement": "2026-09-03",
  "tranche_effectifs": "53",
  "categorie_entreprise": "GE",
  "economie_sociale_solidaire": "N",
  "nic_siege": "00048",
  "etablissements": [
    {
      "siret": "35600000000048",
      "siren": "356000000",
      "siege": true,
      "etat": "A",
      "enseigne": "LA POSTE",
      "complement": "DIRECTION GENERALE DE LA POSTE",
      "numero": "9",
      "type_voie": "RUE",
      "voie": "DU COLONEL PIERRE AVIA",
      "code_postal": "75015",
      "commune": "PARIS",
      "code_commune": "75115",
      "activite_principale": "53.10Z"
    }
  ],
  "source": "INSEE, Sirene, stock du 2026-10-01"
}

La clé donne accès à votre compte : gardez-la côté serveur, jamais dans du code exécuté par le navigateur. Chaque appel avec clé consomme un crédit Nubelo, quelle que soit la recherche (SIREN, SIRET, nom ou adresse) ; le solde restant est dans l'en-tête X-Credits-Restants (illimite avec l'abonnement illimité).

Lire la réponse

Les champs sans valeur sont omis de la réponse. Les codes (catégorie juridique, activité, effectifs) sont ceux de l'Insee.

Diffusion partielle

Une personne physique peut demander que ses données ne soient pas diffusées. Dans ce cas, la réponse contient "diffusion_partielle": true et seulement les informations non nominatives : pas de nom, pas d'adresse précise, et l'entreprise n'apparaît pas dans les recherches par nom.

Chercher une entreprise

Par nom

La recherche renvoie d'abord les entreprises dont le nom commence par le texte saisi, puis celles dont un nom (dénomination, sigle, nom d'usage ou enseigne) contient tous les mots saisis, dans n'importe quel ordre, le dernier pouvant être incomplet : « conseil pod » retrouve POD CONSEIL. Les accents et la casse sont ignorés. Elle est adaptée à la saisie assistée : proposez les résultats pendant la frappe, puis gardez le SIREN choisi.

curl "https://api.nubelo.fr/v1/entreprises/recherche?nom=la%20poste&limite=2" \
  -H "X-API-Key: VOTRE_CLE"

Trois caractères au moins. Par défaut seules les entreprises actives sont renvoyées ; ajoutez actives=0 pour inclure les cessées. limite va de 1 à 100 (20 par défaut).

Par adresse

Vous saisissez une adresse en texte libre : Kompaz la fait vérifier et normaliser par Adralis, puis renvoie les établissements situés à cette adresse, les sièges et les actifs d'abord. Comme les autres appels, elle consomme un crédit, pas davantage.

curl -G "https://api.nubelo.fr/v1/entreprises/recherche" \
  --data-urlencode "adresse=9 rue du colonel pierre avia 75015 paris" \
  -H "X-API-Key: VOTRE_CLE"

Réponse (extrait)

{
  "adresse": {
    "saisie": "9 rue du colonel pierre avia 75015 paris",
    "lignes": ["", "", "", "9 RUE DU COLONEL PIERRE AVIA", "", "75015 PARIS", ""],
    "statut": "VALIDE",
    "indice_confiance": 95,
    "code_insee": "75115",
    "voie": "RUE DU COLONEL PIERRE AVIA",
    "numero": "9"
  },
  "niveau": "numero",
  "resultats": [
    {
      "denomination": "LA POSTE",
      "voie_exacte": true,
      "siret": "35600000000048",
      "siren": "356000000",
      "siege": true,
      "etat": "A",
      "numero": "9",
      "type_voie": "RUE",
      "voie": "DU COLONEL PIERRE AVIA",
      "code_postal": "75015",
      "commune": "PARIS"
    }
  ],
  "plus": true,
  "source": "INSEE, Sirene, stock du 2026-10-01"
}

adresse montre ce qu'Adralis a compris : vérifiez le statut avant de vous fier aux résultats (INCERTAINE : adresse à faire confirmer). niveau vaut numero si l'adresse a un numéro, voie sinon. voie_exacte est faux quand la voie est écrite autrement dans Sirene, par exemple sans article ou abrégée. plus indique qu'il y a davantage d'établissements que la limite : dans un grand immeuble, ils peuvent être des centaines. Une adresse qu'Adralis ne reconnaît pas répond 422 et consomme tout de même le crédit. Les établissements à diffusion partielle n'apparaissent jamais dans une recherche par adresse.

Erreurs et limites

Une erreur répond avec un code HTTP et un objet {"erreur": "…"} qui l'explique en français.

Sans clé, le débit est limité par adresse IP (quelques requêtes par seconde). Avec une clé, il n'est pas limité par adresse IP.

Les données

Kompaz s'appuie sur le stock Sirene publié par l'Insee, diffusé en licence ouverte. La date du stock est indiquée dans le champ source de chaque réponse. Il est renouvelé tous les mois : une entreprise créée ou modifiée depuis n'apparaît qu'au stock suivant.

Sirene décrit les entreprises et leurs établissements. Il ne contient pas les dirigeants, ni les comptes, ni les bénéficiaires effectifs.

Référence

Le bouton Authorize enregistre votre clé pour la page ; Try it out envoie de vrais appels.