Disposable Email Check

Body parameters

• emailstringoptional

  The email address you want to validate. Required unless you send domain.

  e.g. "user@mailinator.com"

• domainstringoptional

  Domain to validate directly, instead of an email. Required unless you send email.

  e.g. "mailinator.com"

Quick start

import axios from 'axios';

const response = await axios.post(
  'https://graph.sendcorex.com/v4/mail/isdisposable',
  {
    email: "user@mailinator.com"
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);

console.log(response.data);

Response

{
  "isDisposable": true,
  "highRisk": true,
  "code": "fully_confirmed",
  "reason": "Confirmed",
  "name": "mailinator.com",
  "checks": [
    {
      "check": "Domain Blocklist Match",
      "status": "Failed",
      "details": "Domain found in known disposable list"
    },
    {
      "check": "MX Record Check",
      "status": "Passed",
      "details": "Looks legitimate"
    },
    {
      "check": "MX Record Present",
      "status": "Passed",
      "details": "Domain has valid MX records"
    }
  ],
  "remainingCredits": 42,
  "responseTime": "87ms"
}

Response fields

• isDisposable

  true if the domain is a confirmed disposable provider.

• highRisk

  true if the email or domain shows high-risk signals, even if it is not confirmed disposable.

• code

  Verdict code, for example fully_confirmed or clear.

• reason

  Human-readable explanation of the verdict.

• name

  The domain name that was checked.

• checks

  Breakdown of the individual checks performed, each with check, status and details.

• remainingCredits

  Credits left on your plan. Returns "Unlimited" on unlimited plans.

Errors

HTTP-level errors return type, code and message. Errors marked CMD come back inside the command result, with HTTP 200.

• 401INVALID_API_KEY

  The API key is invalid or revoked.