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 POST /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
Email address
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
POST /email/verifyAPI Explorer ↗Explicit mailbox verification with a JSON email body
JSON body required
Send Content-Type: application/json.
emailstring · required
Use only the fields listed for this format. Put these inputs in the body.
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
- Mailbox likely exists. Null when the mailbox check did not complete
- catchallLink to catchallboolean or null
- Domain accepts all addresses. Null when the mailbox check did not complete
- statusLink to statusstring or null
- Mailbox result: deliverable, undeliverable, risky, or null when unavailable.
- reasonLink to reasonstring or null
- Why the address received this result, such as mailbox_full or mailbox_not_found. Null when unavailable.
- 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.