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
POST /v1/validation/single-emailcurl -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
| Champ | Type | Requis | Description |
|---|---|---|---|
email | string | Oui | Adresse 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.
{
"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
}
}
}| Champ | Type | Description |
|---|---|---|
status | string | Statut de la validation. Voir Statuts. |
uuid | string | Identifiant de la validation. |
created_at | string | Date de création de la validation (YYYY-MM-DD HH:MM:SS). |
email.email | string | Adresse vérifiée. |
email.status | string | success ou error : si la vérification a pu être effectuée. |
email.classification | string ou null | valid, invalid, catch_all, risky ou unknown ; null en cas d'erreur. |
email.reason | string ou null | Motif lisible du résultat. |
email.reason_code | string ou null | Code stable du résultat. |
email.advanced | bool | Si 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
| Code | HTTP | Quand |
|---|---|---|
1313 | 400 | Le champ email est manquant. |
1304 | 400 | Pas assez de crédits de validation. |
1314 | 500 | La vérification a échoué dans le service de validation. |
Consultez la référence des erreurs pour la liste complète.
Endpoints associés
POST /v1/validation/bulk— valider de nombreuses adresses à la foisPOST /v1/validation/file— valider les adresses d'un fichier- Validation des destinataires — valider pendant l'envoi, sans appeler cette API
