Skip to content

POST /v1/validation/single-email ​

Valide une seule adresse et renvoie le résultat immédiatement. C'est le seul endpoint synchrone de l'API de validation : il renvoie le uuid de la validation, mais il n'y a rien à interroger ensuite, car le résultat est déjà dans la réponse.

Il utilise un crédit de validation quelle que soit la classification obtenue. S'il ne vous reste plus de solde, la requête est rejetée avec le code 1304.

Endpoint ​

http
POST /v1/validation/single-email
bash
curl -X POST https://api.mailiqo.com/v1/validation/single-email \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Corps de la requête ​

ChampTypeRequisDescription
emailstringOuiAdresse email à valider.

Réponse ​

Code 201. La réponse a la même forme que le détail d'une validation en masse, avec une seule adresse : les données de la validation au-dessus et le résultat dans email.

json
{
  "status": "success",
  "data": {
    "status": "COMPLETED",
    "uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx",
    "created_at": "2026-01-01 10:29:07",
    "email": {
      "email": "[email protected]",
      "status": "success",
      "classification": "valid",
      "reason": "Mailbox exists",
      "reason_code": "mailbox_exists",
      "advanced": true
    }
  }
}
ChampTypeDescription
statusstringStatut de la validation. Voir Statuts.
uuidstringIdentifiant de la validation.
created_atstringDate de création de la validation (YYYY-MM-DD HH:MM:SS).
email.emailstringAdresse vérifiée.
email.statusstringsuccess ou error : si la vérification a pu être effectuée.
email.classificationstring ou nullvalid, invalid, catch_all, risky ou unknown ; null en cas d'erreur.
email.reasonstring ou nullMotif lisible du résultat.
email.reason_codestring ou nullCode stable du résultat.
email.advancedboolSi la boîte mail a réellement été sondée.

Il y a deux champs status dans cette réponse

Celui de l'extérieur est le statut de la validation (COMPLETED, ERROR...). Celui à l'intérieur de email est celui de la vérification de cette adresse. Pour savoir si l'adresse est bonne, lisez classification, pas status. Voir Le résultat d'une adresse.

classification n'est pas un booléen

Une adresse non joignable n'est pas nécessairement invalid : elle peut être catch_all, risky ou unknown. Décidez sur la classification complète, pas sur une équivalence valide/invalide. Voir Classifications.

Erreurs ​

CodeHTTPQuand
1313400Le champ email est manquant.
1304400Pas assez de crédits de validation.
1314500La vérification a échoué dans le service de validation.

Consultez la référence des erreurs pour la liste complète.

Endpoints associés ​

Built with VitePress