Vérifier un email ou soumettre un lot CSV.

Authentification

Chaque requête passe une clé API dans l'en-tête `Authorization: Bearer bj_live_xxx`.

Endpoint de vérification

curl -X POST https://api.mailkleaner.com/v1/verify \
  -H "Authorization: Bearer bj_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"email":"alice@company.com"}'

Réponse type

{
  "data": {
    "email": "alice@company.com",
    "normalizedEmail": "alice@company.com",
    "result": "VALID",
    "score": 96,
    "checks": {
      "mx_found": true,
      "smtp_reachable": true,
      "disposable": false,
      "free_provider": false,
      "role_based": false
    },
    "smtp": {
      "mx_host": "mx1.company.com",
      "code": "250",
      "reason": "accepted"
    },
    "meta": {
      "source": "LIVE",
      "checked_at": "2026-05-09T09:12:01.000Z",
      "cache_ttl_seconds": 604800,
      "response_version": "2026-05-09"
    }
  }
}

Lots CSV

Un upload crée un batch asynchrone, débite les crédits et expose le résultat via polling ou webhook.