Email Validator: Disposable
Check Disposable
Tells you in milliseconds if an address or domain is disposable or high-risk, so you can block fake signups. It does not talk to the mailbox server: use Validate Email for that.
https://g.sendcorex.com/v1/tool/validatecommand: check_disposableNeeds the tools:validate scope on your API key.
Uses 1 disposable credit (not a validation credit). Unlimited plans are never charged.
Send email or domain. With an email, the fraud reputation of the address is checked too.
Arguments
emailstringoptionalThe address to check. Up to 254 characters.
e.g.
"john@mailinator.com"domainstringoptionalOnly the domain, when you do not have the full address.
e.g.
"mailinator.com"
Quick start
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "check_disposable",
args: {
email: "john@mailinator.com"
}
}
]
},
{ 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);Response
{
"type": "SUCCESS",
"results": [
{
"command": "check_disposable",
"id": "0",
"type": "SUCCESS",
"took_ms": 2,
"data": {
"email": "john@mailinator.com",
"domain": "mailinator.com",
"is_disposable": true,
"high_risk": true,
"code": "fully_confirmed",
"reason": "Confirmed",
"checks": [
{
"check": "Domain Blocklist Match",
"status": "Failed",
"details": "Domain found in known disposable list"
}
],
"unlimited": false,
"remaining_credits": 4999
}
}
]
}Response fields
emailThe address you sent, trimmed and in lowercase.
nullwhen you sent only adomain.domainThe domain that was checked.
is_disposabletruefor temporary/throwaway providers. Block the signup.high_risktruewhen the address is disposable OR was flagged for fraud on Sendcorex before. Block or send to review.codefully_confirmedwhen something was found,clearwhen nothing was.reasonA short explanation of the verdict.
checksThe checks that ran (
check,status,details). See Checks below.remaining_creditsDisposable credits left after this check.
nullon an unlimited plan.unlimitedtrueon an unlimited plan.
Checks
From the cheapest to the slowest. A domain on the blocklist answers right away, without any DNS lookup.
Email Reputation CheckOnly appears when it fails: the address was flagged for fraud on Sendcorex. Sets
high_risk, notis_disposable.Domain Blocklist MatchThe domain is a known disposable provider. When it fails, nothing else runs: the answer comes back right away.
MX Record CheckThe domain is hosted on infrastructure used by disposable providers, even if it is not on any list yet.
MX Record PresentInformative: the domain has MX records. A domain with no MX cannot receive email (often a typo), but this alone does not make it disposable.
Using the result
Signup formsCall it before creating the account. When
is_disposableistrue, ask for another address.High riskhigh_riskwithoutis_disposableis a real mailbox flagged for fraud on Sendcorex. Block it or hold the account for review.Disposable vs. Validate EmailThis check is instant and cheap. Validate Email also asks the mailbox server if the address exists, which takes seconds: use it before sending.
Errors
HTTP-level errors return type, code and message. Errors marked CMD come back inside the command result, with HTTP 200.
- 401
INVALID_API_KEYThe API key does not exist, was revoked or was disabled in the dashboard.
- 429
RATE_LIMITEDMore than 75 requests/s or 75 in flight for the same IP + API key. Wait the number of seconds in Retry-After.
- CMD
MISSING_SCOPEThe API key does not have `tools:validate`.
- CMD
INVALID_ARGSAn argument is invalid: missing email (or domain, for `check_disposable`), more than 50 emails, an address longer than 254 characters, limit out of range…
- CMD
INSUFFICIENT_CREDITSYou do not have enough credits for the whole command (validation credits for `validate_*`, disposable credits for `check_disposable`). Nothing was checked and nothing was charged.
- CMD
CREDITS_UNAVAILABLEYour credits could not be read right now. Nothing was charged. Try again.
- CMD
INTERNALServer error. The detail is only written to the server log.