Les questions
les plus fréquentes

La France, la Belgique, la Suisse, la Norvège, la Finlande, la Lettonie, l'Irlande, la Suède, l'Estonie, la Lituanie, l'Australie, Singapour, le Japon et le Royaume-Uni. L'API sert les 14 pays avec le même format : par exemple FR-552032534 pour un SIREN, BE-0417497106 pour un numéro d'entreprise belge, CH-101374515 pour un numéro IDE suisse, NO-923609016 pour un numéro d'organisation norvégien, FI-01120389 pour un Y-tunnus finlandais, LV-40003245752 pour un numéro d'enregistrement letton, IE-104547 pour un numéro de société irlandais, SE-5560427220 pour un numéro d'organisation suédois, EE-10137025 pour un code d'enregistrement estonien, LT-110053842 pour un code de personne morale lituanien, AU-51824753556 pour un numéro ABN australien de 11 chiffres, SG-196800306E pour un UEN singapourien de 9 ou 10 caractères, JP-1180301018771 pour un numéro d'entreprise japonais de 13 chiffres, GB-00445790 pour un company number britannique. Les détails par pays sont dans la documentation.

Oui. L'API v2 sert environ 2 millions d'entreprises belges actives et leurs unités d'établissement, issues du registre officiel des entreprises belges. L'identifiant est BE- suivi du numéro d'entreprise de 10 chiffres, par exemple BE-0417497106 ; les formes 0417.497.106, BE0417497106 et l'ancien numéro à 9 chiffres sont acceptées, et la clé de contrôle modulo 97 est vérifiée. Le numéro de TVA belge, BE suivi du numéro d'entreprise, est lui aussi vérifié. Les signaux insolvency_proceedings (faillite, réorganisation judiciaire) et liquidation (dissolution ou liquidation en cours) viennent de la situation juridique de l'entreprise. Seules les entités actives sont servies : une entreprise qui a cessé n'est plus trouvée, et la surveillance la signale alors comme retirée du registre.

Oui. L'API v2 sert environ 795 000 entités juridiques suisses actives, de toutes formes (sociétés anonymes, Sàrl, raisons individuelles, coopératives, associations, fondations, succursales…), issues du registre du commerce suisse. L'identifiant est CH- suivi des 9 chiffres du numéro IDE, sans le préfixe CHE, par exemple CH-101374515 pour CHE-101.374.515 ; les formes CHE-101.374.515, CHE101374515 et le numéro de TVA CHE-101.374.515 MWST sont acceptées, et la clé de contrôle modulo 11 est vérifiée. Le numéro de TVA suisse est lui aussi vérifié. Le signal liquidation vient de la mention « en liquidation » dans le nom inscrit. Les établissements, les annonces légales et les bénéficiaires effectifs ne sont pas disponibles en Suisse.

Oui. L'API v2 sert environ 1,2 million d'unités juridiques norvégiennes, entreprises individuelles comprises, avec leurs établissements. L'identifiant est NO- suivi des 9 chiffres du numéro d'organisation, par exemple NO-923609016 ; la clé de contrôle modulo 11 est vérifiée et le numéro de TVA NO923609016MVA est accepté. Elle sert aussi environ 463 000 entités finlandaises (FI- suivi des 8 chiffres du Y-tunnus sans le trait d'union, par exemple FI-01120389 pour 0112038-9, clé modulo 11 vérifiée) et environ 218 000 entités lettonnes actives (LV- suivi des 11 chiffres du numéro d'enregistrement, par exemple LV-40003245752), les entités radiées restant consultables. Les numéros de TVA finlandais et lettons sont vérifiés ; celui de la Norvège est lu dans le registre officiel de la TVA. Les signaux de faillite et de liquidation sont fournis pour la Norvège et la Finlande, le signal de liquidation pour la Lettonie. Les annonces légales et les bénéficiaires effectifs ne sont pas disponibles ; les établissements ne le sont qu'en Norvège.

Oui. L'API v2 sert environ 345 000 sociétés irlandaises actives, de toutes formes (sociétés privées par actions, sociétés à activité désignée, sociétés limitées par garantie, sociétés anonymes, sociétés étrangères enregistrées en Irlande), et environ 480 000 sociétés dissoutes ou radiées, qui restent consultables avec leur date. L'identifiant est IE- suivi du numéro de société, de 1 à 7 chiffres, par exemple IE-104547 ; ce numéro n'a pas de clé de contrôle, seul son format est vérifié. L'activité est la classe NACE rév. 2 du registre, quand elle est renseignée. Les signaux de liquidation, d'administration, de radiation d'office proposée et de déclaration annuelle en retard sont fournis. Le numéro de TVA irlandais ne se déduit pas du numéro de société : le bloc TVA n'est pas disponible. Les établissements, les annonces légales et les bénéficiaires effectifs ne sont pas disponibles.

Oui. L'API v2 sert environ 1,18 million d'organisations suédoises actives, de toutes formes (sociétés anonymes, sociétés en nom collectif et en commandite, associations de logement, coopératives, associations, fondations, entités publiques), et environ 1,03 million d'organisations radiées, qui restent consultables avec leur date. L'identifiant est SE- suivi des 10 chiffres du numéro d'organisation, par exemple SE-5560427220 pour 556042-7220 ; la clé de contrôle (Luhn) est vérifiée. Le numéro de TVA suédois, SE suivi du numéro d'organisation et de 01, est lui aussi vérifié. Les signaux de faillite, de réorganisation et de liquidation sont fournis. Les entrepreneurs individuels ne sont pas servis. Les établissements, les annonces légales et les bénéficiaires effectifs ne sont pas disponibles.

Oui. L'API v2 sert environ 355 000 entités estoniennes, de toutes formes (sociétés à responsabilité limitée, sociétés anonymes, sociétés en commandite et en nom collectif, associations, associations de copropriétaires, fondations, coopératives, succursales, collectivités), en activité, en liquidation ou en faillite. L'identifiant est EE- suivi des 8 chiffres du code d'enregistrement, par exemple EE-10137025 ; la clé de contrôle est vérifiée. Le numéro de TVA estonien (EE suivi de 9 chiffres) est lu dans le registre, accepté à la place du code, et vérifié. L'activité est l'activité principale déclarée (code EMTAK). Les signaux de liquidation et de faillite sont fournis. Une entité qui disparaît du registre est conservée comme fermée, sans date de fin. Les entrepreneurs individuels ne sont pas servis. Les établissements, les annonces légales et les bénéficiaires effectifs ne sont pas disponibles.

Oui. L'API v2 sert environ 233 000 personnes morales lituaniennes actives, de toutes formes (sociétés à responsabilité limitée, sociétés anonymes, petites sociétés, entreprises individuelles, associations, établissements publics, coopératives, collectivités), et environ 315 000 personnes morales radiées, qui restent consultables avec leur date. L'identifiant est LT- suivi des 9 chiffres du code de la personne morale, par exemple LT-110053842 ; la clé de contrôle est vérifiée. Le numéro de TVA lituanien, LT suivi du code, est lui aussi vérifié. Les signaux de faillite et de liquidation sont fournis. Le registre ne publie ni adresse, ni code d'activité, ni établissements. Les annonces légales et les bénéficiaires effectifs ne sont pas disponibles.

Oui. L'API v2 sert environ 6,1 millions d'entités australiennes actives (sociétés, trusts, sociétés de personnes, fonds de pension et entrepreneurs individuels) et environ 6,7 millions d'ABN annulés, qui restent consultables. L'identifiant est AU- suivi des 11 chiffres de l'ABN, par exemple AU-51824753556 ; les formes 51 824 753 556 et ABN 51824753556 sont acceptées, et la clé de contrôle modulo 89 est vérifiée. Le registre ne donne ni rue ni code d'activité : l'adresse se limite à l'État et au code postal. Le nom d'un entrepreneur individuel n'est jamais conservé : la fiche est servie sous son nom commercial. La TVA n'est pas vérifiée pour l'Australie ; l'inscription à la taxe sur les biens et services (GST) est donnée telle qu'elle est publiée. Les signaux de fermeture et de création récente, le contrôle des sanctions et la surveillance sont disponibles ; les établissements, les annonces légales et les bénéficiaires effectifs ne le sont pas.

Oui. L'API v2 sert environ 635 000 entités singapouriennes actives (sociétés locales, entreprises individuelles, sociétés de personnes, succursales de sociétés étrangères) et environ 1,5 million d'entités radiées, dissoutes ou cessées, qui restent consultables. L'identifiant est SG- suivi du UEN, par exemple SG-196800306E ; la lettre de contrôle est vérifiée. L'activité est le code SSIC et le registre ne donne pas de date de fin. Les signaux de fermeture, de création récente, de radiation proposée, de liquidation et de procédure collective, le contrôle des sanctions et la surveillance sont disponibles ; les établissements, les annonces légales et les bénéficiaires effectifs ne le sont pas. La TVA n'est pas vérifiée pour Singapour.

Oui. L'API v2 sert environ 5,1 millions de sociétés et organisations japonaises actives et environ 780 000 fermées, qui restent consultables avec leur date de fermeture. L'identifiant est JP- suivi des 13 chiffres du numéro d'entreprise, par exemple JP-1180301018771 ; le chiffre de contrôle est vérifié. Le nom et l'adresse sont en japonais, avec la lecture en katakana et le nom anglais quand ils existent ; la recherche par nom trouve un texte d'au moins 2 caractères dans ces trois formes. Le registre ne donne ni code d'activité ni date de création, et les entrepreneurs individuels n'ont pas de numéro. Le signal de fermeture, le contrôle des sanctions et la surveillance sont disponibles ; les établissements, les annonces légales et les bénéficiaires effectifs ne le sont pas. La TVA n'est pas vérifiée pour le Japon.

Jsonpage rassemble, contrôle, harmonise et enrichit les informations des registres officiels des entreprises de chaque pays couvert : environ 5,7 millions de sociétés actives au Royaume-Uni, environ 2 millions d'entreprises actives en Belgique, environ 795 000 entités juridiques actives en Suisse, environ 1,2 million d'unités actives en Norvège, environ 463 000 entités actives en Finlande, environ 218 000 entités actives en Lettonie, environ 345 000 sociétés actives en Irlande, environ 1,18 million d'organisations actives en Suède, environ 355 000 entités actives en Estonie, environ 233 000 personnes morales actives en Lituanie, environ 6,1 millions d'entités actives en Australie, environ 635 000 entités actives à Singapour, environ 5,1 millions de sociétés et organisations actives au Japon et l'ensemble des entreprises et établissements français. S'y ajoutent les annonces légales, les informations réglementaires publiques et les listes de sanctions internationales. Le résultat : des données à jour, au même format dans les 14 pays, avec une TVA vérifiée en Europe. Les réponses sont en JSON, avec un temps de réponse typique de quelques millisecondes côté serveur.

Oui. Les données proviennent des registres officiels de chaque pays et des listes de sanctions internationales, et sont tenues à jour. Chaque réponse de l'API indique la date des données utilisées. Voir l'état du service

Le statut « P » indique une diffusion partielle demandée par la personne concernée. Les noms et adresses ne sont jamais stockés ni renvoyés ; l'identifiant, l'activité et le statut restent disponibles.

Une réponse 404 signifie que l'identifiant est inexistant, mal saisi ou que l'unité n'est pas encore inscrite au registre. Vérifiez le format : 9 chiffres pour un SIREN, 14 pour un SIRET composé du SIREN et d'un NIC de 5 chiffres.

Il est indicatif. Le bloc sanctions de l'API v2, disponible en France, en Belgique, en Suisse, en Norvège, en Finlande, en Lettonie, en Irlande, en Suède, en Estonie, en Lituanie, en Australie, à Singapour, au Japon et au Royaume-Uni, compare l'entreprise aux principales listes de sanctions internationales et nationales (Union européenne, Nations unies, Royaume-Uni, États-Unis et France), par numéro d'immatriculation et par nom. Seules les entités sont comparées, jamais les personnes physiques. Une absence de correspondance n'est pas une garantie et ne remplace pas vos propres vérifications (KYC, lutte contre le blanchiment), comme le précisent les CGV.

Au Royaume-Uni, oui : le bloc owners de l'API v2 liste les personnes ayant un contrôle significatif (PSC) en cours, telles qu'inscrites au registre britannique, sans adresse ni jour de naissance. En France et en Belgique, non : le registre des bénéficiaires effectifs n'est plus public depuis le 31 juillet 2024, et son accès est réservé aux autorités, aux professionnels assujettis et aux personnes justifiant d'un intérêt légitime ; ils ne sont pas non plus disponibles pour la Belgique. En Suisse, en Norvège, en Finlande, en Lettonie, en Irlande, en Suède, en Estonie, en Lituanie, en Australie, à Singapour et au Japon non plus : les registres ne les publient pas.

Chaque appel transmet une clé API dans l'en-tête X-API-Key. Une clé n'est affichée qu'une fois, à sa création, et le serveur n'en conserve qu'une empreinte. Depuis le tableau de bord (Clés API), vous pouvez créer, nommer, renouveler et révoquer vos clés : une clé renouvelée continue de fonctionner 24 heures, le temps de déployer la nouvelle ; une clé révoquée cesse aussitôt de fonctionner.

Oui, avec un forfait payant : jusqu'à 3 clés actives en même temps en Standard et 10 en Pro (1 en Découverte). Donnez un nom à chacune, par exemple production, recette ou le nom d'un client, pour les reconnaître dans le tableau de bord. Pour changer une clé sans interruption de service, renouvelez-la : la nouvelle clé fonctionne immédiatement et l'ancienne reste valable 24 heures, puis elle est désactivée. Une clé révoquée, elle, cesse aussitôt de fonctionner.

Un SIREN identifie une entreprise avec 9 chiffres. Un SIRET identifie un établissement avec 14 chiffres : le SIREN suivi d'un NIC de 5 chiffres.

Avec le forfait Pro, le tableau de bord accepte jusqu'à 20 adresses IP ou plages d'adresses, en IPv4 ou en IPv6 (par exemple 203.0.113.10 ou 203.0.113.0/24), et affiche votre adresse actuelle pour l'ajouter facilement. La liste s'applique à toutes les clés du compte : une requête venant d'une autre adresse est refusée avec le code 403 ip_not_allowed. Une liste vide accepte toutes les adresses.

Avec l'API v2 : GET /v2/companies?q= suivi du nom, par exemple q=danone. Chaque mot doit figurer dans le nom et le dernier peut être un début de mot (« dano » trouve DANONE) ; la casse, les accents et la ponctuation sont ignorés. Les noms exacts sortent en premier, puis les entreprises actives. Les paramètres country, status et limit affinent la recherche, qui compte pour une seule requête. Les unités à diffusion partielle (statut « P ») ne peuvent pas être trouvées par leur nom.

Votre formulaire appelle une route de votre serveur, qui ajoute votre clé API et appelle GET /v2/autocomplete?q= suivi du texte saisi : n'appelez jamais l'API directement depuis le navigateur, la clé serait visible. Attendez environ 150 ms après la dernière frappe avant chaque appel. Chaque suggestion donne l'identifiant, le nom, le code postal et la ville, en quelques millisecondes ; un SIREN ou un SIRET saisi trouve directement l'entreprise. Une fois l'entreprise choisie, GET /v2/validate vérifie en un appel le SIREN, le SIRET et le numéro de TVA. Chaque appel compte pour une requête. Un exemple complet côté serveur est dans la documentation.

L'API renvoie le code 429 et l'en-tête Retry-After, qui indique le nombre de secondes à attendre. Chaque réponse, quel que soit le forfait, contient aussi l'en-tête X-RateLimit-Remaining, qui donne le nombre de requêtes encore disponibles dans la minute en cours. Réessayez après le délai indiqué, avec une temporisation progressive si nécessaire.

Avec la surveillance de l'API v2 : PUT /v2/monitors/{id} ajoute une entreprise à votre liste, par exemple FR-552032534. Jsonpage compare les entreprises surveillées aux registres officiels, aux annonces légales, aux bénéficiaires effectifs et aux listes de sanctions ; chaque changement de statut, de nom, d'adresse, d'activité, de forme juridique, de signaux, d'annonces légales, de sanctions ou de bénéficiaires effectifs devient un événement. Vous le recevez sur votre webhook, configuré dans le tableau de bord (Surveillance) et signé par HMAC-SHA256, ou vous le lisez avec GET /v2/events, qui garde les événements 90 jours. Le forfait Découverte (gratuit) surveille 2 entreprises, Standard 1 000 et Pro 10 000. Chaque appel aux routes de surveillance compte pour une requête ; les livraisons de webhooks ne sont pas comptées. Un changement est signalé une fois inscrit dans les registres officiels.

Oui. En plus du webhook et de GET /v2/events, le tableau de bord vous permet de recevoir les événements par e-mail, au choix dès qu'ils sont détectés ou en un résumé quotidien. Les alertes partent vers 1 adresse en Découverte, jusqu'à 3 en Standard et jusqu'à 10 en Pro, en français, en anglais, en néerlandais ou en allemand. Les e-mails ne comptent pas comme des requêtes.

Dans le tableau de bord, déposez votre fichier CSV et choisissez la colonne des identifiants : SIREN, SIRET, numéros de TVA français, belges, norvégiens, finlandais ou lettons, numéros IDE suisses (avec ou sans MWST), Y-tunnus finlandais, ou identifiants globaux comme FR-552032534, BE-0417497106, CH-101374515, NO-923609016, FI-01120389 ou LV-40003245752. Seule cette colonne est envoyée. Vous récupérez un fichier CSV complété avec, pour chaque ligne, le nom, le statut, la forme juridique, l'adresse, l'activité, le numéro et le statut de TVA, les signaux, les procédures collectives et le contrôle indicatif des sanctions. Un fichier compte jusqu'à 10 000 lignes en Standard et 100 000 en Pro ; le forfait Découverte permet d'enrichir 100 lignes par mois ; chaque ligne compte pour une requête. Le fichier complété reste téléchargeable 7 jours.

Oui, avec Standard et Pro, pour les entreprises françaises. Choisissez l'activité (code NAF ou division), le département, la forme juridique et la période de création : le tableau de bord affiche le nombre d'entreprises trouvées et un aperçu, puis vous téléchargez la liste en CSV (SIREN, nom, activité, forme juridique, date de création et adresse du siège). Vous pouvez exporter 1 000 lignes par mois civil en Standard et 50 000 en Pro. Les listes ne comprennent que des entreprises actives dont la diffusion est publique ; les entrepreneurs individuels n'y figurent jamais. Si vous les utilisez pour prospecter, vous restez responsable du respect du RGPD et des règles de la CNIL : informez les entreprises contactées, respectez leur opposition et n'envoyez pas d'e-mail de prospection à une personne physique sans son accord préalable ; vers une adresse professionnelle, le message doit concerner son activité.

Oui, l'appel depuis un navigateur est techniquement possible, mais votre clé API serait visible par tous les visiteurs. Appelez l'API depuis votre serveur pour garder cette clé privée. La démo du site fonctionne sans clé et se limite à 10 recherches par minute.

Aucun quota mensuel sur les forfaits payants. Le forfait Découverte est limité à 1 000 requêtes par jour, avec une remise à zéro à minuit UTC. Pour le reste, seule la vitesse des appels est limitée : Découverte (gratuit) est à 0 € avec 100 requêtes/min et Standard à 19 € HT/mois avec 1 000 requêtes/min. Pro, à 129 € HT/mois, n'a pas de plafond de débit lié au forfait ; un plafond d'usage raisonnable de 10 000 requêtes/min par compte protège le service.

Le forfait Pro n'a pas de plafond de débit lié au forfait, mais il n'est pas sans limite : un plafond d'usage raisonnable de 10 000 requêtes par minute et par compte protège le service pour tous. Au-delà, l'API renvoie le code 429, comme pour les autres forfaits.

Oui, pour le forfait Pro : 99,9 % de disponibilité mensuelle, avec un avoir sur la facture si cet engagement n'est pas tenu. Le forfait Standard a le même objectif, sans avoir ; le forfait Découverte (gratuit) est fourni au mieux. Les conditions sont détaillées sur la page SLA.

Vous pouvez créer un compte Découverte (gratuit), sans carte bancaire, sur jsonpage.com/account. Votre clé API vous est donnée dès que vous confirmez votre adresse e-mail ; vous pouvez ensuite passer à Standard ou Pro depuis le tableau de bord. Le paiement par carte passe par Stripe et les offres sont sans engagement.

Le tableau de bord affiche le nombre de requêtes du jour et des 30 derniers jours, avec un graphique jour par jour. Chaque appel compte pour une requête, quels que soient les blocs demandés. Dans une requête groupée, chaque entreprise compte pour une requête : un lot de 100 entreprises en vaut 100 ; de même, chaque ligne d'un fichier enrichi compte pour une requête. Le journal des requêtes détaille chaque appel sur 7 jours en Découverte, 30 jours en Standard et 90 jours en Pro. Avec un forfait payant, il s'exporte en CSV, comme vos entreprises surveillées et vos événements.

Prix fixe, pas de crédits. Le paiement se fait par carte bancaire via Stripe, au mois ou à l'année, avec une facture à chaque échéance. Les prix sont indiqués hors taxes : Standard à 19 € HT/mois ou 182 € HT/an, Pro à 129 € HT/mois ou 1 238 € HT/an. Le forfait Découverte (gratuit) ne demande aucune carte.

Oui, pour Standard et Pro, avec 20 % de remise : 182 € HT par an au lieu de 228 € pour Standard, et 1 238 € HT par an au lieu de 1 548 € pour Pro. Choisissez le paiement annuel en souscrivant, ou passez du mensuel à l'annuel depuis le portail client Stripe. L'année est payée d'avance et se renouvelle automatiquement ; une résiliation prend effet à la fin de l'année payée, sans remboursement au prorata.

Dans le tableau de bord (Abonnement), le bouton « Gérer l'abonnement et les factures » ouvre le portail client Stripe. Vous pouvez y changer de forfait, résilier et télécharger vos factures. Les offres sont sans engagement : une résiliation prend effet à la fin de la période déjà payée, mois ou année.

Stripe réessaie automatiquement le paiement. Pendant ce temps, l'abonnement est en retard de paiement et votre forfait payant reste actif. Si le paiement n'est pas régularisé, le compte revient au forfait Découverte (gratuit).