Email API
Format, domain, role, and a typo suggestion, on every call.
Pass an email address up to 254 characters. Malformed addresses return 400 invalid_request. A successful lookup returns format, domain, and role flags and counts as a normal request. The valid field does not establish mailbox deliverability.
Disposable is included on every call. didyoumean is a suggested address when the host looks like a known misspelling, or null. Use explicit GET /email/verify for deliverable and catchall. Completed checks use your account's verification allowance and billing rules. See your included units in Dashboard → Plan. Incomplete checks are not billed.
ValidateCopy link
GET /email/{email}API Explorer ↗Format, domain, role, disposable, mail route and a typo suggestion
Parameters
- emailstring · path · required
Supplied check value. Invalid values return HTTP 200 with valid false.
Length: 0 to 4096 characters
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.email("hello@gmail.com");
console.log(result);{
"email": "hello@gmail.com",
"didyoumean": null,
"valid": true,
"free": true,
"disposable": false,
"role": true,
"domain": "gmail.com",
"domain_type": null,
"domain_valid": true
}Response fields
- emailLink to emailstring
- Address checked
- didyoumeanLink to didyoumeanstring or null
- Suggested address when the host is a known misspelling, else null
- validLink to validboolean
- Syntax valid
- freeLink to freeboolean
- Consumer mailbox such as Gmail, Yahoo, Outlook.com, ISP mail, or iCloud
- disposableLink to disposableboolean
- Temporary or disposable provider
- roleLink to roleboolean
- Role address (info@, support@, …)
- domainLink to domainstring or null
- Host after @
- domain_typeLink to domain_typestring or null
- Reserved namespace of the host: academic, government, military, or null
- domain_validLink to domain_validboolean or null
- Mail route found: MX, or A/AAAA when MX is absent. Explicit null MX is false.
Mailbox verificationCopy link
GET /email/verify?email=person%40example.comAPI Explorer ↗Explicit mailbox verification with an email query parameter
Parameters
- emailstring · query · required
Supplied check value. Invalid values return HTTP 200 with valid false.
Length: 0 to 4096 characters
Existing POST requests with a JSON email body remain supported. Use GET for new integrations. SDKs retain POST when an input is too long or cannot be represented faithfully in a URL.
Deeper signal for signup and outbound. Counts toward your plan's monthly email verification allowance. See Plans.
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.email.verify("jane+news@mit.edu");
console.log(result);{
"email": "jane+news@mit.edu",
"didyoumean": null,
"valid": true,
"free": false,
"disposable": false,
"role": false,
"domain": "mit.edu",
"domain_type": "academic",
"domain_valid": true,
"deliverable": true,
"catchall": false,
"status": "deliverable",
"reason": "accepted",
"first_name": "Jane",
"no_reply": false,
"tag": "news",
"mail_provider": null
}Verification fields
- deliverableLink to deliverableboolean or null
- Independent delivery verdict: true for confirmed delivery, false for a confirmed negative, null when unknown. Catchall and status do not change this fact
- catchallLink to catchallboolean or null
- Independent accept-all behavior: true when known to accept all addresses, false when known not to, null when unknown
- statusLink to statusstring
- Overall assessment: deliverable, undeliverable, risky, or unknown. Risky means a full mailbox, disposable address, or unresolved delivery on a catchall domain. Free and role flags alone do not add risk.
- reasonLink to reasonstring
- Primary assessment code. Unknown uses temporary_failure only for a recorded transient failure; otherwise unconfirmed. Known delivery can coexist with catchall.
- first_nameLink to first_namestring or null
- Suggested first name from the address, or null when ambiguous. Not verified identity.
- no_replyLink to no_replyboolean or null
- Address indicates replies are not expected. Null when the input cannot be parsed.
- tagLink to tagstring or null
- Text after the plus sign, or null. The original address is preserved.
- mail_providerLink to mail_providerstring or null
- Mail service handling the address, such as Google or Microsoft. Null when not identified.