Skip to content

POST /v1/validation/bulk ​

Met en file une liste d'adresses pour validation. Maximum 10 000 par requête.

C'est asynchrone : la réponse ne contient aucun résultat, seulement un uuid que vous utilisez pour les lire ensuite. Si les adresses se trouvent dans un fichier exporté, utilisez plutôt POST /v1/validation/file.

Chaque adresse vérifiée utilise un crédit de validation.

Endpoint ​

http
POST /v1/validation/bulk
bash
curl -X POST https://api.mailiqo.com/v1/validation/bulk \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["[email protected]", "[email protected]"]}'

Corps de la requête ​

ChampTypeRequisDescription
emailsarrayOuiListe d'adresses. Maximum 10 000.

Réponse ​

Code 201. Le uuid identifie la validation pour que vous puissiez interroger son statut et son résultat.

json
{
  "status": "success",
  "data": {
    "uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx"
  }
}
ChampTypeDescription
uuidstringIdentifiant de la validation créée.

Erreurs ​

CodeHTTPQuand
1300400Plus de 10 000 adresses dans la requête.
1304400Pas assez de crédits de validation.
1302500L'enregistrement de la liste d'adresses a échoué.
1303500La création de la demande de validation a échoué.

Le solde est vérifié avant l'acceptation du lot : s'il ne couvre pas chaque adresse, rien n'est mis en file et la requête est rejetée avec 1304.

Étape suivante ​

Avec le uuid, suivez la progression dans GET /v1/validation/status/{uuid} et téléchargez le résultat dans GET /v1/validation/details/{uuid}/{page}.

Endpoints associés ​

Built with VitePress