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

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

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.

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
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.