API de l'annuaire des entreprises

L'API ouvre bientôt. La documentation ci-dessous est un aperçu : elle peut encore évoluer d'ici l'ouverture. Être prévenu de l'ouverture

Ce que fait l'API

Vérifier un nouveau client à sa création dans votre CRM : identité, état, dirigeants, procédures en cours.
Enrichir vos fiches avec l'adresse du siège, l'activité, l'effectif, le chiffre d'affaires et le numéro de TVA.
Constituer des listes d'entreprises par activité, lieu, taille ou forme juridique.
Récupérer les documents officiels : statuts, actes et comptes annuels en PDF.

Les données sont les mêmes que sur les fiches de l'annuaire : INSEE, INPI, BODACC, DGFiP, marchés publics, Légifrance et décisions de justice.

Tarifs

L'API se paie en crédits, sans abonnement : une fiche d'entreprise coûte un crédit, une page de 25 résultats un crédit, un document PDF deux, une note de solvabilité vingt. Les packs vont de 1 000 crédits pour 20 € HT à 200 000 pour 2 000 € ; les crédits achetés n'expirent pas et le solde est partagé avec le serveur MCP. 100 crédits sont offerts chaque mois. Voir la grille complète

Authentification

Chaque appel porte votre clé d'API dans l'en-tête Authorization. Toutes les routes sont en lecture (GET) et répondent en JSON, sauf le téléchargement de documents qui renvoie un PDF.

curl "https://…/api/annuaire/fiche?siren=552100554" \
  -H "Authorization: Bearer VOTRE_CLE"

Les routes

Toutes les routes sont préfixées par /api/annuaire. Le SIREN accepte les espaces et les points.

Route	Paramètres	Renvoie
`GET /fiche`	siren	Fiche complète : identité, dirigeants, comptes, procédures, établissements, marques, sociétés liées.
`GET /recherche`	q, departement	Entreprises correspondant à un nom, un sigle, un SIREN ou un SIRET.
`GET /avancee`	filtres, page	Recherche par filtres (activité, lieu, forme, taille, finances, labels…), 25 résultats par page.
`GET /documents`	siren	Actes et comptes annuels déposés au registre national des entreprises.
`GET /document.pdf`	genre (bilan \| acte), id	Le PDF d'un acte ou d'une liasse.
`GET /tva`	siren	Numéro de TVA intracommunautaire et sa validité.
`GET /marches`	siren	Marchés publics remportés : objet, montant, acheteur, date.
`GET /accords`	siren	Accords d'entreprise publiés sur Légifrance.
`GET /contentieux`	siren	Décisions de justice où l'entreprise est partie.
`GET /solvabilite`	siren, encours	Note de solvabilité Acquy : note sur 100, risque, classe de recouvrement, encours conseillé et marge restante.
`GET /rapport.pdf`	siren	Le rapport de solvabilité en PDF.

Exemples de réponse

Une recherche renvoie une liste de candidats :

GET /api/annuaire/recherche?q=peugeot&departement=78

{
  "candidats": [
    {
      "siren": "552100554",
      "nom": "PEUGEOT SA",
      "adresse": "ROUTE DE GIZY 78140 VELIZY-VILLACOUBLAY",
      "etat": "En activité"
    }
  ]
}

Une recherche avancée renvoie une page de résultats et le total :

GET /api/annuaire/avancee?naf=62.01Z&departement=69&effectif_min=10&page=1

{
  "total": 1243,
  "page": 1,
  "par_page": 25,
  "pages": 50,
  "lignes": [ { "siren": "…", "nom": "…", "naf": "62.01Z", "effectif": "…", "ca_dernier": "…" } ]
}

La fiche regroupe ses données par bloc : identite (dont les dirigeants), juridique, exercices, procedures, etablissements, mandats, marques, journal (annonces BODACC) et graphe (sociétés liées).

Codes d'erreur

Une erreur renvoie un objet { "erreur": "…", "code": "…" } avec l'un de ces statuts :

`400`	Paramètre invalide (SIREN mal formé, filtre inconnu).
`401`	Clé absente ou invalide.
`402`	Solde épuisé : rechargez votre compte. La recherche reste gratuite.
`404`	Entreprise introuvable ou non diffusible.
`502`	Une source publique ne répond pas.
`503`	Une source est momentanément saturée : réessayer après le délai indiqué par Retry-After.

Bon à savoir

Un montant absent vaut null : « non publié », à ne pas confondre avec zéro.
Les comptes annuels sont publiés avec six à dix-huit mois de retard ; les annonces du BODACC sont, elles, à jour.
La recherche avancée s'arrête à 10 000 résultats : affinez les filtres au-delà.
Les entreprises en diffusion partielle à l'INSEE sont servies sans leur adresse, comme le veut la loi.

Être prévenu de l'ouverture

L'API de l'annuaire