Les questions
les plus fréquentes.

La France, la Belgique, la Suisse et le Royaume-Uni. L'API v1 sert les entreprises et établissements français par SIREN et SIRET. L'API v2 sert les quatre pays avec le même format : par exemple FR-552100554 pour un SIREN, BE-0417497106 pour un numéro d'entreprise belge, CH-101374515 pour un numéro IDE suisse, 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.

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 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 quatre pays, avec une TVA vérifiée. 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 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 non plus : le registre du commerce ne les publie 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 Gratuit). 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=peugeot. Chaque mot doit figurer dans le nom et le dernier peut être un début de mot (« peug » trouve PEUGEOT) ; 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, avec Express, 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-552100554. 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 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 Gratuit, 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 ou belges, numéros IDE suisses (avec ou sans MWST), ou identifiants globaux comme FR-552100554, BE-0417497106 ou CH-101374515. 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'à 100 lignes en Gratuit, 10 000 en Standard et 100 000 en Pro ; 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.

Non, aucun forfait n'impose de quota mensuel : seule la vitesse des appels est limitée. Le forfait 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 Gratuit est fourni au mieux. Les conditions sont détaillées sur la page SLA.

Vous pouvez créer un compte Gratuit, sans carte bancaire, sur companies.jsonpage.com/account.html. 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 Gratuit, 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.

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 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 d'offre, 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 Gratuit.