Passer au contenu principal
Enrow utilise un système basé sur les crédits, et les crédits ne sont consommés que lorsqu’un résultat est trouvé ou qu’une vérification est effectuée. Cette page explique comment les crédits sont facturés pour chaque endpoint, comment vérifier votre solde, comment gérer les paramètres de facturation et ce qui se passe lorsque les crédits sont épuisés.

​
Comment fonctionnent les crédits ?

Les crédits ne sont consommés que lorsque l’API renvoie un résultat ou termine une vérification — les recherches infructueuses qui ne trouvent rien ne coûtent pas de crédits. Chaque fonctionnalité consomme des crédits à un taux différent :
EndpointCrédits
Email Finder1 par email trouvé
Phone Finder40 par numéro trouvé (par défaut ; 50 avec les anciens forfaits)
Email Verifier0,25 par vérification
Les crédits sont facturés de la même manière pour les opérations unitaires et groupées — par résultat individuel. Lancer une recherche d’emails groupée sur 1 000 noms coûte le même prix par email trouvé que 1 000 recherches unitaires.
Chaque requête qui consomme des crédits renvoie un champ credits_used dans sa réponse, ce qui vous permet de suivre la consommation par recherche. Consultez Trouver un email pour un exemple de réponse.

​
Comment vérifier mon solde de crédits ?

Interrogez l’endpoint du compte avec votre clé d’API dans l’en-tête x-api-key pour récupérer votre solde de crédits actuel. Aucun corps de requête n’est nécessaire — le compte est identifié à partir de la clé d’API. 
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Response
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
La réponse contient votre solde et vos webhooks enregistrés :
FieldDescription
creditsVotre solde de crédits actuel
webhooksTableau des URL de vos webhooks enregistrés
Pour la référence complète de l’endpoint, consultez Infos du compte. Vous pouvez également visiter votre Tableau de bord pour consulter les détails d’utilisation et de facturation, ou consulter le guide d’Authentification pour comprendre le fonctionnement de l’en-tête x-api-key sur tous les endpoints.

​
Comment gérer les paramètres de facturation ?

Depuis la page de facturation de l’application, vous pouvez configurer trois options qui maintiennent votre compte approvisionné et vous alertent avant que les crédits ne soient épuisés :
Renouvelez automatiquement votre forfait à son expiration. Définissez le montant de crédits à renouveler dans le champ de saisie situé à côté du bouton bascule.
Achetez automatiquement des crédits supplémentaires à l’usage lorsque votre solde devient faible. Définissez le montant de crédits à recharger dans le champ de saisie situé à côté du bouton bascule.
Recevez une alerte par email lorsque votre solde de crédits descend en dessous d’un seuil. Définissez le seuil de crédits dans le champ de saisie situé à côté du bouton bascule.

​
Que se passe-t-il lorsque les crédits sont épuisés ?

Lorsque votre solde de crédits atteint zéro, les requêtes API renvoient un statut HTTP 402. Les endpoints unitaires (recherche d’email/de numéro unitaire, vérification unitaire) renvoient : 
{
  "reason": "Insufficient credits",
  "success": false
}
Les endpoints groupés renvoient plutôt { "message": "..." }. Pour la liste complète des codes de statut et des formats de réponse, consultez Codes de statut et Gestion des erreurs.
Pour éviter toute interruption, activez le Rechargement automatique ou l’Alerte de solde faible depuis la page de facturation.

​
Quel forfait choisir ?

Rendez-vous sur enrow.io/pricing pour comparer les forfaits et trouver celui qui correspond à vos besoins. Des crédits à l’usage peuvent être ajoutés à n’importe quel forfait via le Rechargement automatique.

​
FAQ

Non. Les crédits ne sont consommés que lorsqu’un email ou un numéro de téléphone est trouvé, ou lorsqu’une vérification est effectuée. Une recherche qui ne renvoie aucun résultat ne coûte pas de crédits.
Non. Les crédits sont facturés par résultat individuel, donc une opération groupée coûte le même prix par email, numéro ou vérification trouvé que les requêtes unitaires équivalentes. Les endpoints groupés font économiser des requêtes, pas des crédits.
L’Email Verifier consomme 0,25 crédit par vérification. L’Email Finder consomme 1 crédit par email trouvé, et le Phone Finder consomme 40 crédits par numéro trouvé (50 avec les anciens forfaits).
Les requêtes renvoient un statut HTTP 402. Les endpoints unitaires renvoient { "reason": "Insufficient credits", "success": false }, tandis que les endpoints groupés renvoient { "message": "..." }. Consultez Gestion des erreurs pour plus de détails.

​
Prochaines étapes

Authentification

Comment transmettre votre clé d’API dans l’en-tête x-api-key.

Infos du compte

Récupérez votre solde de crédits et vos webhooks enregistrés.

Limites de débit

Comprenez les limites de requêtes de l’API avant de monter en charge.

Gestion des erreurs

Gérez correctement les réponses d’erreur 402 et autres.