← Docs

Email API

Format, domain, role, and a typo suggestion, on every call.

Check an email before you trust it. You get format, domain, and role flags. That counts as a normal request. A string that is not an email answers valid: false as a 200, never a 404.

Disposable comes free on every call from our provider list. didyoumean is a suggested address when the host looks like a known misspelling, or null. Deliverable and catchall live behind ?deep=true. Those calls use your plan's monthly email verification allowance. Free includes 100. Each deep request uses one verification.

Validate

GET
api.parseapi.com/email/{email}
Format, domain, role, disposable, and a typo suggestion. Deep adds deliverable and catchall
curl "https://api.parseapi.com/email/hello@gmail.com" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "email": "hello@gmail.com",
  "didyoumean": null,
  "valid": true,
  "disposable": false,
  "role": false,
  "domain": "gmail.com",
  "domain_valid": true
}
curl "https://api.parseapi.com/email/not-an-email" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "email": "not-an-email",
  "didyoumean": null,
  "valid": false,
  "disposable": false,
  "role": false,
  "domain": null,
  "domain_valid": false
}

Response fields

email
Address checked
didyoumean
Suggested address when the host is a known misspelling, else null
valid
Syntax valid
disposable
Temporary or disposable provider
role
Role address (info@, support@, …)
domain
Host after @
domain_valid
MX records found

Deep verification

Deeper signal for signup and outbound. Counts toward your plan's monthly email verification allowance. See Plans.

curl "https://api.parseapi.com/email/hello@gmail.com?deep=true" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "email": "hello@gmail.com",
  "didyoumean": null,
  "valid": true,
  "disposable": false,
  "role": false,
  "domain": "gmail.com",
  "domain_valid": true,
  "deep": {
    "deliverable": true,
    "catchall": false
  }
}

Deep fields

deep.deliverable
Mailbox likely exists
deep.catchall
Domain accepts all addresses

Questions? Email