API entreprise : rechercher et intégrer un dossier par SIREN

1. Rechercher

   Appelez /v1/recherche?q=... avec une dénomination, un SIREN ou un SIRET (3 à 120 caractères). Vous obtenez 20 résultats par défaut ; limit accepte de 1 à 100.

2. Confirmer l’entité

   Contrôlez la dénomination et l’adresse avant de retenir un résultat. Le dossier /v1/entreprises/{siren} attend un SIREN de neuf chiffres ; utilisez les établissements pour retrouver le site concerné par un SIRET.

3. Sélectionner les champs

   Enrichissez les champs utiles à votre application et conservez la provenance et la date de consultation. Une donnée manquante ne doit pas effacer automatiquement une information déjà validée dans votre CRM.

4. Traiter les exceptions

   Distinguez une recherche sans résultat, une restriction de diffusion et une indisponibilité du service. Prévoyez une validation humaine lorsqu’un rapprochement est ambigu.

Le SIREN identifie l’unité légale ; le SIRET identifie un établissement. Retrouvez la définition du SIREN par l’Insee et le catalogue des données disponibles.

Datenza est un service distinct des API publiques des registres. La disponibilité d’un champ dépend de la source, de sa diffusion et des données reçues. Vérifiez les informations sensibles avant de les utiliser pour une décision concernant un client ou un fournisseur.

Les recherches, fiches et documents consomment le solde commun de votre offre. Un appel à /v1/entreprises/{siren}/documents coûte deux fois une fiche : 80 crédits en Starter, 60 en Growth et 40 en Scale. Consultez les tarifs par opération et les cas d’enrichissement CRM.

Les références documentaires sont indépendantes des PDF stockés. catalogue_complete indique si le catalogue INPI de l’entreprise a été vérifié. Avant cette vérification, count vaut null ; known_count indique les références déjà connues. Une liste vide en cours de vérification ne prouve pas l’absence de documents. Un PDF absent du stockage est récupéré auprès de l’INPI puis conservé lors de sa première demande autorisée.

Le dossier expose meta.sections pour distinguer les données complètes, partielles, en cours de vérification et les seuls événements observés. Les annonces, comptes et dirigeants suivent la même règle : count: null ne signifie pas zéro. Les historiques de mandats et la chronologie décrivent les événements connus, sans promesse d’exhaustivité. Les filtres etat, limit et offset sont transmis pour les établissements ; un filtre sans résultat renvoie une liste vide, sans déclarer l’entreprise introuvable.

Les anciens dirigeants et mandataires sont également recherchés dans les états historiques officiels du RNE, aux dates des actes et annonces connus. Ces états sont conservés et intégrés aux fiches et à /representatives. Les champs premier_etat_connu et dernier_etat_connu indiquent les dates des états attestant le mandat, pas ses dates exactes de début et de fin. meta.historique_recovery_pending signale une vérification non terminée ; l’absence de résultat à ce stade ne prouve pas l’absence d’ancien mandat. meta.historique_recovery_state et meta.representants_recovery_state distinguent queued (en attente), processing (traitement actif), deferred (différé) et ready (traitement terminé).