Facturation

L’API facture en crédits. Chaque requête coûte le prix de base de son endpoint, plus les fonctionnalités qui renvoient des données et les éventuels suppléments choisis. Les prix sont les mêmes dans chaque plan. Ton plan détermine les fonctionnalités que tu peux utiliser.

Tu demandes les fonctionnalités de fetch-organization une par une. Chacune ne coûte que si elle renvoie des données :

Avec toutes les fonctionnalités et les deux suppléments, une requête à fetch-organization coûte au plus 215 crédits. Cette étendue est incluse dans Max.

Un moniteur coûte un prix fixe par période de 30 jours, selon l’intervalle de vérification. Sa création et la première référence sont gratuites.

Un intervalle entre ces paliers coûte autant que le palier plus fréquent suivant. Plus d’informations sous account/monitors.

Une fonctionnalité sans données ne coûte rien. Si elle renvoie null ou une liste vide, tu ne la paies pas. Cela vaut pour chaque fonctionnalité, y compris insolvency_publications : sans publications d’insolvabilité, elle est gratuite.

Le prix de base et les suppléments suivent leurs propres règles. Tu paies le prix de base pour chaque profil d’entreprise livré. Le mode IA coûte même sans correspondance. Le mode temps réel coûte pour chaque récupération en direct réussie, même si rien n’a changé au registre. Plus d’informations sous Suppléments.

Pour certaines fonctionnalités, un contenu précis compte :

• shareholders et shareholders_deep ne coûtent que s’il y a des entrées actuelles. Un historique seul est gratuit.
• mergers_and_acquisitions ne coûte qu’avec des transactions, des relations de contrôle ou des successions juridiques.
• network ne coûte qu’avec au moins un lien.
• news coûte dès que la liste contient au moins un article.

fetch-organization omet une fonctionnalité que ton plan n’inclut pas et ne la facture pas.

Avec Recherche & Export, les documents et Signals, tu paies la requête elle-même : une page de résultats, un document, une page de Signals. Une recherche sans résultat et une page vide de Signals sont aussi facturées.

Une requête échouée ou refusée ne coûte rien, voir Erreurs.

fetch-organization a deux suppléments que tu actives par requête.

Mode IA (ai_search=on-default, +20 crédits) trouve l’entreprise même à partir d’une saisie vague et fait des recherches sur le web. Il est facturé dès que la recherche a eu lieu, même s’il ne trouve aucune entreprise ou que la source de données signale une erreur. Il n’est pas facturé seulement si l’API interrompt la requête avec 408.

Mode temps réel (realtime_mode=handelsregister-default, +10 crédits) récupère en direct les personnes inscrites au Handelsregister (registre du commerce). Nous facturons le supplément quand la récupération en direct réussit, quel que soit son résultat. _realtime_mode.status a alors la valeur success.

Toute autre valeur signifie que la récupération en direct a échoué. Tu obtiens alors les données enregistrées et paies le reste de la requête, sans le supplément temps réel. Si la requête dure trop longtemps, l’API répond 408 et ne facture rien.

Chaque réponse indique ce qu’elle a coûté. Dans les réponses JSON, c’est dans meta, pour les documents dans les headers.

Les refus à l’authentification (401, 403) et au-delà de la limite (429) arrivent généralement sans meta. Ils ne coûtent jamais rien.

Tu trouves chaque facturation sous Compte › Utilisation et via l’API à GET /v1/account/usage/transactions, voir account.

Avant que l’API traite une requête, elle vérifie si ton solde couvre le coût le plus élevé possible : prix de base, toutes les fonctionnalités demandées et les suppléments. Sinon, l’API répond 402 et ne facture rien.

La réponse indique ce maximum dans meta.request_credit_cost et ton solde dans meta.credits_remaining. Le montant facturé ensuite est souvent plus bas, car les fonctionnalités sans données ne coûtent rien.

Un exemple : les données de base avec le mode IA et la fonctionnalité ubos nécessitent 35 crédits à l’avance. Si ubos ne renvoie aucune donnée, la requête coûte 25 crédits.

signals répond avec des Problem Details et le code INSUFFICIENT_CREDITS.

Chaque nouveau compte reçoit 150 crédits de départ. Ils sont valables 30 jours.

Avec un abonnement de crédits (Plus, Pro, Max ou Enterprise), tu reçois des crédits chaque mois. Ils sont valables jusqu’à la fin de la période de facturation. Si tu changes de plan, tu emportes les crédits mensuels inutilisés dans la nouvelle période. À partir de Plus, tu peux utiliser fetch-person ; Pro et Max débloquent des données supplémentaires.

Tu achètes des crédits de recharge ponctuellement, en plus. Sans abonnement de crédits, ils sont valables 30 jours. Tant qu’un abonnement de crédits est en cours, ni les crédits de recharge ni les crédits de départ n’expirent.

Tu vois ton solde et ce qui expire quand sous Compte › Crédits et via l’API à GET /v1/account/credits.

Tous les plans et prix figurent sur la page des tarifs.