> ## Documentation Index > Fetch the complete documentation index at: https://docs.enrow.io/llms.txt > Use this file to discover all available pages before exploring further. # Codes de statut > Référence des codes de statut HTTP de l'API Enrow et des valeurs de qualification de recherche, pour savoir comment gérer chaque réponse L'API Enrow utilise des codes de statut HTTP standard pour indiquer le résultat de chaque requête, ainsi qu'un champ `qualification` qui vous renseigne sur le résultat d'une recherche ou d'une vérification. Cette page répertorie tous les codes et toutes les valeurs de qualification afin que vous puissiez gérer les réponses de manière fiable. Pour les messages d'erreur correspondants et les formats de réponse, consultez [Gestion des erreurs](/fr/error-handling). ## Quels codes de statut HTTP l'API renvoie-t-elle ? L'API Enrow utilise des codes de statut HTTP standard pour indiquer le résultat de chaque requête. Un code `2xx` signifie que la requête a réussi, un code `4xx` indique un problème avec la requête, et un code `5xx` signifie qu'un problème est survenu du côté d'Enrow. ### Quels codes signifient un succès ? Un code de statut `2xx` signifie que l'API a accepté la requête. Les opérations asynchrones (telles que les recherches groupées) renvoient `201` ou `202` car le traitement se poursuit en arrière-plan. | Code | Signification | Description | | ------- | ------------- | ------------------------------------------------ | | **200** | OK | Requête réussie, résultats renvoyés | | **201** | Created | Ressource créée (ex. : recherche groupée lancée) | | **202** | Accepted | Requête acceptée, traitement asynchrone | ### Quels codes signifient que la requête a été rejetée ? Un code de statut `4xx` signifie que l'API a rejeté la requête en raison d'un problème corrigeable côté client : paramètres invalides, clé API manquante ou invalide, crédits insuffisants ou trop de requêtes. | Code | Signification | Description | | ------- | ----------------- | --------------------------------- | | **400** | Bad Request | Paramètres invalides ou manquants | | **401** | Unauthorized | Clé API invalide ou manquante | | **402** | Payment Required | Crédits insuffisants | | **429** | Too Many Requests | Limite de débit dépassée | Un `401` signifie que la clé API est manquante ou invalide : consultez [Authentification](/fr/authentication) pour savoir comment la transmettre correctement. Un `402` signifie que le compte n'a plus de crédits ; vérifiez la consommation dans [Crédits et facturation](/fr/credits-billing). Un `429` signifie que la requête a dépassé le débit autorisé : consultez [Limites de débit](/fr/rate-limits) pour comprendre les seuils. L'API ne renvoie jamais **404**. Un identifiant de recherche inconnu ou expiré renvoie **400** pour les endpoints groupés et **500** pour les endpoints unitaires. ### Quels codes signifient une erreur serveur ? Un code de statut `5xx` signifie que la requête était valide mais qu'un problème est survenu du côté d'Enrow. Ces réponses peuvent être réessayées sans risque après un court délai. | Code | Signification | Description | | ------- | --------------------- | ------------------------------------- | | **500** | Internal Server Error | Un problème est survenu de notre côté | ## Que sont les qualifications de recherche ? Une qualification de recherche est la valeur du champ `qualification` qui vous indique le résultat d'une recherche ou d'une vérification. Enrow renvoie ce champ sur tous les endpoints, et le résultat est toujours **binaire** : il n'y a pas de « peut-être » ni de score de probabilité. C'est un choix de conception délibéré. ### Pourquoi le résultat est-il binaire ? Le résultat est binaire car une réponse claire par oui ou par non est plus simple à exploiter qu'une probabilité. La plupart des outils d'enrichissement renvoient un ensemble complexe de catégories (catch-all, à risque, inconnu, invérifiable, etc.) qui vous obligent à construire une logique autour de probabilités. Enrow a adopté l'approche inverse : * **Enrow vérifie même les e-mails catch-all de manière déterministe**, ce qui rend inutile toute catégorie « catch-all » * Enrow ne croit pas aux systèmes probabilistes comportant des dizaines de classifications : ils ajoutent de la complexité sans apporter de clarté * Un résultat binaire signifie que vous pouvez exploiter les données immédiatement, sans avoir à les remettre en question Le résultat est bon ou il ne l'est pas. Simple. ### Quelles qualifications l'Email Finder renvoie-t-il ? L'[Email Finder](/fr/api-reference/email-finder/find-single) renvoie l'une des valeurs suivantes dans le champ `qualification` : | Qualification | Signification | | ------------- | --------------------------- | | `valid` | E-mail trouvé et vérifié | | `invalid` | E-mail non trouvé | | `ongoing` | Recherche toujours en cours | ### Quelles qualifications l'Email Verifier renvoie-t-il ? L'[Email Verifier](/fr/api-reference/email-verifier/verify-single) renvoie l'une des valeurs suivantes dans le champ `qualification` : | Qualification | Signification | | ------------- | --------------------------------- | | `valid` | E-mail valide et délivrable | | `invalid` | E-mail invalide ou non délivrable | | `ongoing` | Vérification toujours en cours | `invalid` n'a pas la même signification selon l'endpoint : sur l'**Email Finder**, cela signifie que l'e-mail n'a pas été trouvé. Sur l'**Email Verifier**, cela signifie que l'e-mail existe mais n'est pas délivrable. ### Quelles qualifications le Phone Finder renvoie-t-il ? Le [Phone Finder](/fr/api-reference/phone/find-single) renvoie l'une des valeurs suivantes dans le champ `qualification` : | Qualification | Signification | | ------------- | ---------------------------------------- | | `found` | Numéro de téléphone localisé avec succès | | `not_found` | Numéro de téléphone introuvable | | `ongoing` | Recherche toujours en cours | ### Comment suivre une recherche groupée ? Pour les opérations groupées, un champ `status` indique l'avancement du lot. Interrogez l'endpoint GET concerné — [résultats groupés de l'Email Finder](/fr/api-reference/email-finder/get-bulk-results), [vérifications groupées de l'Email Verifier](/fr/api-reference/email-verifier/get-bulk-verifications) ou [résultats groupés du Phone Finder](/fr/api-reference/phone/get-bulk-results) — jusqu'à ce que le `status` soit `completed`. | Status | Signification | | ----------- | ------------------------------------------- | | `ongoing` | Le lot est toujours en cours de traitement | | `completed` | Toutes les recherches du lot sont terminées | | `failed` | Le lot a échoué | ## FAQ Un `401 Unauthorized` signifie que la clé API est manquante ou invalide. Assurez-vous que chaque requête inclut une clé valide dans l'en-tête `x-api-key`. Consultez [Authentification](/fr/authentication) pour plus de détails. Un `402 Payment Required` signifie que le compte ne dispose pas de suffisamment de crédits pour traiter la requête. Rechargez votre compte ou vérifiez comment les crédits sont consommés par endpoint dans [Crédits et facturation](/fr/credits-billing). L'API Enrow ne renvoie jamais `404`. Un identifiant de recherche inconnu ou expiré renvoie `400` pour les endpoints groupés et `500` pour les endpoints unitaires. Vérifiez bien l'`id` renvoyé lors du lancement de la recherche. Non. `ongoing` signifie que la recherche ou la vérification est toujours en cours. Interrogez à nouveau l'endpoint GET après un court délai, ou utilisez un webhook pour être notifié automatiquement lorsqu'elle se termine : consultez [Fonctionnement des webhooks](/fr/how-webhooks-work). ## Étapes suivantes Consultez l'ensemble des messages d'erreur et des formats de réponse pour chaque code de statut. Transmettez votre clé API dans l'en-tête x-api-key pour éviter les erreurs 401. Comprenez les seuils qui déclenchent une réponse 429. Découvrez comment les crédits sont consommés et évitez les erreurs 402.