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
| Champ | Type | Description |
|---|---|---|
uuid | string | Identifiant 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"
}
}| 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). |
totalEmails | int | Nombre d'adresses dans la validation. |
invalidEmails | int | Adresses invalides. Seulement quand le statut est COMPLETED. |
validEmails | int | Adresses valides. Seulement quand le statut est COMPLETED. |
fileStatus | string | Statut 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
| Code | HTTP | Quand |
|---|---|---|
1301 | 404 | Le uuid n'existe pas ou n'appartient pas à votre compte. |
1303 | 500 | L'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}.
