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

Example

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.email("hello@gmail.com");
console.log(result);
Example response
{
  "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.

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.email.verify("jane+news@mit.edu");
console.log(result);
Example response
{
  "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.