MailTester Ninja

Check in real time whether an email address exists and can receive mail, by asking the recipient's mail server (no message is sent). Returns code "ok" (valid), "ko" (invalid) or "mb" (uncertain, such as a catch-all domain) with a message.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "minLength": 3,
      "maxLength": 254,
      "description": "The email address to verify"
    }
  },
  "required": [
    "email"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string"
    },
    "code": {
      "type": "string",
      "description": "\"ok\" valid, \"ko\" invalid, \"mb\" uncertain"
    },
    "message": {
      "type": "string",
      "description": "Accepted, Rejected, Catch-All, No MX, Disposable, Timeout..."
    },
    "domain": {
      "type": [
        "string",
        "null"
      ]
    },
    "mx": {
      "type": "string"
    }
  },
  "required": [
    "email",
    "code",
    "message",
    "domain",
    "mx"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Find the work email address of a person from their name and their company domain. Tries the 6 most common patterns (first.last, flast, first, firstlast, first_last, f.last) one by one and returns the first address the mail server accepts. Stops early when the domain accepts every address (catch-all) and then gives the most common pattern as "guess". Each pattern tried counts as one verification. Personal email providers such as gmail.com are not searched. Requires a paid MailTester Ninja key.

{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "First name, for example Jean-Pierre"
    },
    "last_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Last name, for example De La Tour"
    },
    "domain": {
      "type": "string",
      "minLength": 3,
      "maxLength": 253,
      "description": "Company domain, for example example.com"
    }
  },
  "required": [
    "first_name",
    "last_name",
    "domain"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "email": {
      "description": "The address the mail server accepted, when found",
      "type": [
        "string",
        "null"
      ]
    },
    "format": {
      "description": "Pattern of the returned address: first.last, flast, first, firstlast, first_last or f.last",
      "type": [
        "string",
        "null"
      ]
    },
    "confidence": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "high",
            "medium",
            "low"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "For an address found: high (first and last name in it), medium (an initial, a namesake may share it), low (first name only)"
    },
    "guess": {
      "description": "On a catch-all domain, the most common pattern; for a full mailbox, that address. Not verified.",
      "type": [
        "string",
        "null"
      ]
    },
    "code": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "tried": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Number of address patterns checked, each one counted as a verification"
    },
    "tested": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "email",
          "code",
          "message"
        ],
        "additionalProperties": false
      },
      "description": "Every address checked, in order, with its verdict"
    },
    "reason": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "found",
    "email",
    "format",
    "confidence",
    "guess",
    "code",
    "message",
    "tried",
    "tested",
    "reason"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}