Intégration API Pappers
Nous développons votre connecteur Pappers
Votre application interroge l'API Pappers pour constituer un dossier entreprise en un appel : identité légale, dirigeants, bénéficiaires effectifs, documents officiels.
- Équipe produit senior
- connecteurs de données entreprise en production
- du cadrage au monitoring
À quoi sert l'API Pappers et pourquoi l'utiliser pour enrichir ses données entreprise ?
Pappers est un agrégateur français de données légales et financières sur les entreprises. Son API renvoie à partir d'un SIREN une fiche consolidée : identité, représentants, bénéficiaires effectifs, comptes annuels, procédures collectives, publications BODACC et documents officiels. On l'intègre pour automatiser l'enrichissement d'une fiche client ou prospect à la saisie, réaliser des vérifications KYC lors de l'onboarding, ou surveiller l'état légal et financier d'un portefeuille de partenaires. La facturation au crédit consommé la rend adaptée à un usage ponctuel comme à un flux quotidien.
Ce que nos clients construisent sur l'API Pappers
Dossier d'entrée en relation
Saisie du SIREN, récupération de l'identité légale, des dirigeants, des bénéficiaires effectifs et de l'extrait, dossier constitué sans pièce demandée.
Contrôle de risque avant signature
Blocage automatique sur une procédure collective en cours et alerte sur radiation, au moment d'ouvrir un encours ou de signer un contrat.
Comptes annuels récupérés sans relance
Les comptes déposés alimentent votre scoring interne ou un dossier de financement, sans demander une pièce de plus à l'entreprise.
Veille de portefeuille par alerte
Une liste de surveillance remplace la revue trimestrielle manuelle : procédure ouverte, changement de dirigeant, radiation, vous êtes prévenu.
Ce que ça change dans vos dossiers
La technique au service d'un résultat mesurable : moins de pièces demandées, un risque vu à temps, un coût maîtrisé.
Un dossier au lieu de trois circuits
Identité, dirigeants, bénéficiaires et documents arrivent ensemble. Vous cessez de composer entre Sirene, le RNE, le BODACC et le greffe.
Le risque vu avant l'encours
Une procédure collective en cours ne se découvre plus après la livraison. Le contrôle devient automatique à chaque étape sensible.
Plus de pièces à réclamer au client
Extraits, statuts et comptes annuels se récupèrent par API. Le délai d'un dossier de crédit ou de référencement se raccourcit d'autant.
Un coût que vous voyez venir
Chaque appel est chiffré en crédits et instrumenté. Vous savez ce que coûte une consultation avant de l'ouvrir à toute votre équipe.
Comment nous livrons votre connecteur Pappers
Cadrage
Quels champs, quel volume, quel budget de crédits. On chiffre le coût par appel avant d'écrire une ligne de code, pas après la première facture.
Développement
Connecteur typé qui admet le nullable, compteur de crédits par appel, cache aligné sur la fraîcheur réelle, clé isolée en secret managé.
Recette
Rejeu sur vos données réelles, test sur une entreprise en diffusion partielle, vérification du traitement du 206 et des listes tronquées.
Monitoring
Alerte à seuil sur le solde de crédits, coupe-circuit applicatif, journal des appels et de leur coût. La panne de budget se voit avant l'arrêt.
Ce que permet l'API Pappers
- Fiche entreprise consolidée
- Identité, greffe, statuts RCS et RNE, TVA intracommunautaire vérifiable, procédures collectives et statut consolidé, en un seul appel.
- Dirigeants et bénéficiaires
- Représentants et bénéficiaires effectifs, plus la détection d'un même dirigeant derrière plusieurs sociétés de votre portefeuille.
- Documents et comptes annuels
- Actes, statuts, comptes annuels, extraits et avis de situation, récupérés par API au lieu d'être demandés au greffe ou à l'entreprise.
- Surveillance et autocomplétion
- Listes de surveillance avec alerte à l'événement, et une route de suggestions utilisable côté navigateur pour vos formulaires publics.
Le vocabulaire de l'API Pappers
- Crédit
- L'unité de facturation. Une fiche entreprise coûte 1 crédit, un résultat de recherche 0,1, un document 3, un scoring 30. C'est la grille qu'il faut poser avant de coder, pas après la première facture.
- champs_supplementaires
- Le paramètre qui ajoute des champs facturés à l'unité. La même requête passe de 1 à 31 crédits si elle embarque un scoring financier. Chaque champ demandé doit être une décision explicite, pas un copier-coller.
- statut_consolide
- Un champ de synthèse valant actif, inactif ou cessé, qui agrège les statuts INSEE, RNE et RCS. C'est lui qu'on affiche à un utilisateur métier, plutôt que trois statuts qui peuvent se contredire.
- HTTP 206
- Résultat partiel : au moins une source amont n'a pas répondu dans le temps imparti. Tester status égal à 200 traite ce cas en erreur, tester status inférieur à 300 enregistre une fiche trouée comme complète. Les deux sont faux.
- diffusable
- Le drapeau qui signale une entreprise en diffusion partielle. Une quinzaine de champs deviennent alors nullables, dont la dénomination et l'adresse. Un client TypeScript qui les type non nuls casse en production.
- opposition_utilisation_commerciale
- Le champ qui indique que l'entreprise s'oppose à l'utilisation commerciale de ses données. Le lire et le respecter n'est pas une option : c'est le mécanisme d'opposition prévu par le code de commerce, exposé en booléen.
Les contraintes réelles de l'API Pappers
La facture se cache dans les champs supplémentaires
Une fiche entreprise coûte 1 crédit, la même requête avec un scoring financier en coûte 31. Sans compteur de coût instrumenté dans l'application, la dérive ne se voit qu'à la facture du mois suivant.
Les crédits expirent, et l'API s'arrête
Sur les offres mensuelles et annuelles, les crédits non consommés sont perdus en fin de période, et l'API cesse de répondre quand le solde est épuisé. C'est une panne fonctionnelle qu'aucun monitoring HTTP classique ne voit venir.
Un 206 n'est ni un succès ni une erreur
Il signale une fiche incomplète parce qu'une source amont n'a pas répondu. Il faut le traiter comme un troisième état, remettre l'enregistrement en file, et ne jamais lire l'absence d'un champ comme une information négative.
Un seul compte API par entreprise
Pappers annonce supprimer les comptes multiples non validés au préalable. Le schéma une clé par environnement ou une clé par client final suppose donc un accord commercial explicite, à obtenir avant de concevoir l'architecture.
Pappers ou l'API Sirene ?
Deux façons d'obtenir la fiche d'une entreprise française. Le bon choix dépend de ce que vous devez en faire, pas du prix affiché.
| Critère | PappersAgrégateur payant | INSEE / SireneSource officielle |
|---|---|---|
| Accès | Abonnement, coût au crédit | Compte INSEE, clé gratuite |
| Périmètre | Identité, dirigeants, actes | Identification, localisation |
| Documents officiels | Statuts, comptes, extraits | Non couverts |
| Procédures collectives | Drapeau prêt à l'emploi | Non couvertes |
| Débit | Selon l'offre souscrite | 30 appels par minute |
| Mode de panne | Solde de crédits épuisé | Indisponibilité du service |
| Le bon cas | Constituer un dossier KYC | Vérifier, préremplir un SIRET |
Nous recommandons une architecture à deux niveaux : Pappers pour l'enrichissement à valeur, une source publique pour l'identification de base et le repli.
Ce que nous mesurons sur une intégration Pappers
Les autres API entreprise
Si Pappers ne couvre pas votre besoin, ces options se discutent au cadrage.
PappersNous développons votre connecteur PappersCette page
INSEE / SireneLe répertoire officiel, gratuit : vérifier un SIRET, préremplir une fiche.
Annuaire des entreprisesL'API publique de la DINUM : recherche par nom, gratuite et sans clé.
BODACCLes annonces légales : créations, ventes, procédures collectives.On combine Pappers avec
La stack qui entoure Pappers sur nos projets.
Intégration Pappers : vos questions
Trois étapes. Créer un compte API et récupérer la clé, qui se transmet dans l'en-tête api-key et jamais dans l'URL. Construire ensuite un connecteur serveur qui appelle la fiche entreprise par SIREN, en typant les champs comme nullables pour les entreprises en diffusion partielle et en traitant le code 206 comme un troisième état, ni succès ni erreur. Enfin, poser un cache aligné sur la fraîcheur réelle de la source, qui est actualisée une fois par jour, et un compteur de crédits par appel. Seule la route de suggestions peut être appelée depuis le navigateur : tout le reste passe par votre serveur.
La facturation est au crédit, avec une grille publique : une fiche entreprise coûte 1 crédit, un résultat de recherche 0,1, un document PDF ou XLSX 3, un scoring financier 30. L'offre d'entrée relevée en août 2026 est de 500 crédits par mois pour 30 euros, avec des paliers jusqu'à 100 000 crédits, une réduction sur l'engagement annuel et une formule Pay As You Go sans expiration. Le vrai poste de coût n'est pas le tarif, c'est le nombre d'appels : un cache correct et des champs supplémentaires demandés à bon escient divisent la facture.
Cela dépend de ce que vous devez faire de la donnée. Pour vérifier un SIRET et préremplir un formulaire, l'API Sirene de l'INSEE suffit et elle est gratuite. Pour constituer un dossier de conformité ou d'entrée en relation, Sirene ne suffit pas : elle ne contient ni dirigeants, ni bénéficiaires effectifs, ni actes, ni comptes. Pappers agrège ces sources et livre en plus les documents. Nous recommandons souvent une architecture à deux niveaux, avec la source publique pour l'identification de base et le repli, et l'agrégateur pour l'enrichissement à valeur.
Les comptes annuels, oui, par API, au format PDF, XLSX, texte ou JSON, chacun facturé selon la grille de crédits. Les bénéficiaires effectifs exigent une habilitation, et leurs champs nominatifs les plus sensibles, comme la date de naissance complète, les nationalités ou l'adresse personnelle, exigent une habilitation supplémentaire et un paramètre dédié. Autrement dit, on ne peut pas promettre un module de conformité complet sans avoir traité ce point en amont. Nous le vérifions au cadrage, avant de le chiffrer.
L'API cesse de répondre. Ce n'est pas une panne technique, donc aucun monitoring HTTP classique ne l'anticipe, et sur les offres mensuelles ou annuelles les crédits non consommés sont perdus en fin de période. Nous branchons systématiquement une supervision du solde avec alerte à seuil et un coupe-circuit applicatif, plus un repli sur une source publique gratuite pour l'identification de base : le formulaire d'inscription doit rester fonctionnel même en milieu de mois, budget épuisé.
Un projet d'intégration Pappers ?
Parlons-en. 30 minutes pour cadrer votre besoin, projeter votre consommation de crédits et vous dire franchement ce qui est faisable.
Parler de mon projet Pappers