Skip to content

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 ​

ChampTypeDescription
uuidstringIdentifiant renvoyé à la création de la validation.
pageintPage à 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
  }
}
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).
emailsarrayRésultat par adresse pour cette page.
emails[].emailstringAdresse vérifiée.
emails[].statusstringsuccess ou error : si la vérification a pu être effectuée.
emails[].classificationstring ou nullvalid, invalid, risky, unknown ou catch_all ; null en cas d'erreur.
emails[].reasonstring ou nullMotif quand le résultat n'est pas valid.
emails[].reason_codestring ou nullCode stable du résultat.
emails[].advancedboolSi la boîte mail a réellement été sondée.
pagesintNombre total de pages.
currentPageintPage 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 ​

CodeHTTPQuand
1001400page est inférieur à 1.
1301404Le uuid n'existe pas ou n'appartient pas à votre compte.
1303500L'interrogation de la validation a échoué.

Endpoints associés ​

Built with VitePress