Email Validator : Historique

Lister les validations

Toutes les adresses que vous avez validées, de la plus récente à la plus ancienne, via l'API, le dashboard et vos listes importées. Gratuit : n'utilise pas de crédits.

POSThttps://g.sendcorex.com/v1/tool/validatecommand: list_validations
i

Nécessite le scope tools:validate sur votre API key.

i

L'historique est conservé 365 jours.

Arguments

  • emailstringfacultatif

    Uniquement les validations de cette adresse.

    ex. : "ana@acme.com"

  • limitnumberfacultatif

    Taille de la page, de 1 à 100. Par défaut : 50.

    ex. : 50

  • cursorstringfacultatif

    Le next_cursor de la page précédente. Envoyez-le avec le même email.

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/tool/validate',
  {
    commands: [
      {
        command: "list_validations",
        args: {
          limit: 50
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);

const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);

Réponse

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "list_validations",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 18,
      "data": {
        "validations": [
          {
            "id": "4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
            "email": "ana@acme.com",
            "valid": true,
            "checks": [
              {
                "check": "Format Validation",
                "status": "Passed",
                "details": "Valid email format"
              },
              {
                "check": "Local Part Validation",
                "status": "Passed",
                "details": "Local part is RFC compliant"
              },
              {
                "check": "Role-based Email Check",
                "status": "Passed",
                "details": "Not a role-based address"
              },
              {
                "check": "No-reply Email Check",
                "status": "Passed",
                "details": "Not a no-reply address"
              },
              {
                "check": "Temporary Email Check",
                "status": "Passed",
                "details": "Not a temporary email"
              },
              {
                "check": "Misspelled Domain Check",
                "status": "Passed",
                "details": "Correct"
              },
              {
                "check": "Spam Trap Check",
                "status": "Passed",
                "details": "Not a spam trap"
              },
              {
                "check": "Provider Type",
                "status": "Passed",
                "details": "Corporate or custom domain"
              },
              {
                "check": "Domain Validation",
                "status": "Passed",
                "details": "Domain is valid and has MX records"
              },
              {
                "check": "Null MX Check",
                "status": "Passed",
                "details": "Domain accepts email"
              },
              {
                "check": "Email Provider Detection",
                "status": "Passed",
                "details": "Domain is hosted on a known provider: Google Workspace",
                "providerId": 1,
                "providerName": "Google Workspace"
              },
              {
                "check": "Email Deliverability",
                "status": "Passed",
                "details": "Mailbox exists",
                "fullResponse": "250 2.1.5 OK"
              },
              {
                "check": "Catch-all Mail Exchanger Check",
                "status": "Passed",
                "details": "Mail exchanger correctly rejects nonexistent addresses"
              }
            ],
            "source": "api",
            "created_at": "2026-10-17T06:00:01.204Z"
          }
        ],
        "count": 1,
        "has_more": true,
        "next_cursor": "aDowMDAwMDAwMDgzOjgyMzkzMTU5OTg3OTU6NGM1ZDZlN2Y"
      }
    }
  ]
}

Champs de la réponse

  • validations

    Cette page, de la plus récente à la plus ancienne.

  • validations[].id

    L'id de cette validation.

  • validations[].email / valid / checks

    Comme dans Validate Email.

  • validations[].source

    Où la validation a eu lieu : api, dashboard ou list (un fichier importé).

  • validations[].created_at

    Quand l'adresse a été validée. ISO 8601, UTC.

  • count / has_more / next_cursor

    Tant que has_more vaut true, envoyez next_cursor comme cursor avec le même email.

Erreurs

Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.

  • 401INVALID_API_KEY

    L'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.

  • 429RATE_LIMITED

    Plus de 75 requêtes/s ou 75 simultanées pour la même IP + API key. Attendez le nombre de secondes indiqué dans Retry-After.

  • CMDMISSING_SCOPE

    L'API key n'a pas `tools:validate`.

  • CMDINVALID_ARGS

    Un argument est invalide : e-mail manquant (ou domaine, pour `check_disposable`), plus de 50 e-mails, une adresse de plus de 254 caractères, limit hors limites…

  • CMDINVALID_CURSOR

    Le cursor est mal formé ou provient d'une autre recherche. Recommencez sans cursor.

  • CMDINTERNAL

    Erreur serveur. Le détail n'est écrit que dans le log du serveur.