Skip to content

GET /v1/validation/status/{uuid} ​

Renvoie le statut d'une validation créée avec bulk ou file. Une fois terminée, il inclut aussi le nombre d'adresses valides et invalides.

Attendez que le statut soit COMPLETED avant de télécharger les détails : jusque-là, le résultat est incomplet.

Endpoint ​

http
GET /v1/validation/status/{uuid}
bash
curl -X GET https://api.mailiqo.com/v1/validation/status/6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx \
  -H "X-API-KEY: YOUR_API_KEY"

Paramètres de chemin ​

ChampTypeDescription
uuidstringIdentifiant renvoyé à la création de la validation.

Réponse ​

json
{
  "status": "success",
  "data": {
    "status": "COMPLETED",
    "uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx",
    "created_at": "2026-01-01 10:29:07",
    "totalEmails": 1000,
    "invalidEmails": 42,
    "validEmails": 958,
    "fileStatus": "IMPORTED"
  }
}
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).
totalEmailsintNombre d'adresses dans la validation.
invalidEmailsintAdresses invalides. Seulement quand le statut est COMPLETED.
validEmailsintAdresses valides. Seulement quand le statut est COMPLETED.
fileStatusstringStatut du fichier. Seulement sur les validations créées à partir d'un fichier.

Champs conditionnels

invalidEmails et validEmails n'apparaissent que quand le statut est COMPLETED, et fileStatus seulement sur les validations créées avec file. Ne supposez pas qu'ils sont présents.

Erreurs ​

CodeHTTPQuand
1301404Le uuid n'existe pas ou n'appartient pas à votre compte.
1303500L'interrogation de la validation a échoué.

Étape suivante ​

Une fois le statut COMPLETED, téléchargez le résultat par adresse dans GET /v1/validation/details/{uuid}/{page}.

Built with VitePress