GET /v1/validation/details/{uuid}/{page}
Renvoie le résultat par adresse d'une validation, paginé 1 000 à la fois.
Avant d'appeler cet endpoint, vérifiez avec GET /v1/validation/status/{uuid} que le statut est COMPLETED : jusque-là, le résultat est incomplet.
Endpoint
http
GET /v1/validation/details/{uuid}/{page}bash
curl -X GET https://api.mailiqo.com/v1/validation/details/6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx/1 \
-H "X-API-KEY: YOUR_API_KEY"Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
uuid | string | Identifiant renvoyé à la création de la validation. |
page | int | Page à renvoyer. Commence à 1 ; une valeur inférieure renvoie 1001. |
Utilisez pages de la réponse pour savoir combien de pages vous devez parcourir.
Réponse
json
{
"status": "success",
"data": {
"status": "COMPLETED",
"uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx",
"created_at": "2026-01-01 10:29:07",
"emails": [
{
"email": "[email protected]",
"status": "success",
"classification": "valid",
"reason": null,
"reason_code": "smtp_accepted",
"advanced": true
},
{
"email": "[email protected]",
"status": "success",
"classification": "invalid",
"reason": "Mailbox not found",
"reason_code": "smtp_rejected",
"advanced": true
}
],
"pages": 1,
"currentPage": 1
}
}| 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). |
emails | array | Résultat par adresse pour cette page. |
emails[].email | string | Adresse vérifiée. |
emails[].status | string | success ou error : si la vérification a pu être effectuée. |
emails[].classification | string ou null | valid, invalid, risky, unknown ou catch_all ; null en cas d'erreur. |
emails[].reason | string ou null | Motif quand le résultat n'est pas valid. |
emails[].reason_code | string ou null | Code stable du résultat. |
emails[].advanced | bool | Si la boîte mail a réellement été sondée. |
pages | int | Nombre total de pages. |
currentPage | int | Page renvoyée. |
Les résultats reviennent de la vérification la plus récente à la plus ancienne.
Il y a deux champs status dans cette réponse
Celui de l'extérieur est le statut de la validation (COMPLETED, RUNNING...). Celui à l'intérieur de chaque emails[] est celui de cette vérification précise : success ou error. Pour savoir si une adresse est bonne, lisez classification, pas status. Voir Le résultat d'une adresse.
Erreurs
| Code | HTTP | Quand |
|---|---|---|
1001 | 400 | page est inférieur à 1. |
1301 | 404 | Le uuid n'existe pas ou n'appartient pas à votre compte. |
1303 | 500 | L'interrogation de la validation a échoué. |
Endpoints associés
GET /v1/validation/status/{uuid}— vérifier si elle est terminéePOST /v1/validation/bulk— créer la validation
