Address checks · Mailbox verification

Email verification API

Catch typos.
Verify mailboxes.

Check email addresses at signup. Verify mailbox deliverability before your next send.

Get startedExplore the API

Start free. Address checks on every plan.

Check an email address

Try it

Sample response/email/deliverable%40example.com?deep=true

The Email API

One request.
A clear answer.

Check an address, suggest a correction or verify a mailbox. See the request and complete JSON.

Address checks

Format, mail routing, and address signals.

Request

curl "https://api.parseapi.com/email/hello@gmail.com" \
  -H "X-API-Key: YOUR_API_KEY"

Example response

JSON200 OK
{
  "email": "hello@gmail.com",
  "didyoumean": null,
  "valid": true,
  "free": true,
  "disposable": false,
  "role": true,
  "domain": "gmail.com",
  "domain_type": null,
  "domain_valid": true
}

At signup

Catch email typos
at signup.

A missing letter shouldn't mean a lost customer. Offer a correction while they're still on your form.

Add it to your signup form

Signup example

Create your account

Email address

tom.f@gmal.com

Did you mean gmail.com?

Signup example. The customer chooses whether to use the correction.

Seven checks. One request.

Format, mail routing and the address signals your signup flow needs. Worldwide, on every plan.

Format
Is it an email address?
Mail routing
Can the domain receive mail?
Disposable
Recognize temporary mail providers.
Role
Spot shared inboxes like support@.
Consumer
Recognize personal email services.
Domain type
Academic, government, or military domains.
Typos
Suggest a known domain correction.

Before you send

Check the mailbox.
Read the reason.

Add mailbox deliverability, catchall detection and a recorded reason to the same email lookup.

?deep=true

See the mailbox response
Deliverable
A deliverable result was returned.
Undeliverable
Read the reason before sending.
Catchall
The domain accepts any address. This mailbox stays unconfirmed.
Incomplete
No confirmed answer. Not billed.
No-reply detection
Recognize known no-reply patterns.
Plus tags
The part after +. In jane+news, the tag is news. The address stays intact.
Mail service
Google, Microsoft or another recognized mail service. Unknown stays null.
First-name hint
A possible name from the address.

Email API integration

Your form. Your stack.

Add the check where it belongs.

Browser and server

Use a domain-restricted public key for address checks beside your email field. Keep secret keys and mailbox verification on your server.

HTTP, SDKs and MCP

Copy a request above, or use an SDK in your app. Follow the reference for parameters, complete responses and errors.

Explore the response fields

Response fields

emailstring
Address checked
didyoumeanstring or null
Suggested address when the host is a known misspelling, else null
validboolean
Syntax valid
freeboolean
Consumer mailbox such as Gmail, Yahoo, Outlook.com, ISP mail, or iCloud
disposableboolean
Temporary or disposable provider
roleboolean
Role address (info@, support@, …)
domainstring or null
Host after @
domain_typestring or null
Reserved namespace of the host: academic, government, military, or null
domain_validboolean or null
Mail route found: MX, or A/AAAA when MX is absent. Explicit null MX is false.

Deep fields

deep.deliverableboolean or null
Mailbox likely exists. Null when the mailbox check did not complete
deep.catchallboolean or null
Domain accepts all addresses. Null when the mailbox check did not complete
deep.statusstring or null
Mailbox result: deliverable, undeliverable, risky, or null when unavailable.
deep.reasonstring or null
Why the address received this result, such as mailbox_full or mailbox_not_found. Null when unavailable.
deep.first_namestring or null
Suggested first name from the address, or null when ambiguous. Not verified identity.
deep.no_replyboolean or null
Address indicates replies are not expected. Null when the input cannot be parsed.
deep.tagstring or null
Text after the plus sign, or null. The original address is preserved.
deep.mail_providerstring or null
Mail service handling the address, such as Google or Microsoft. Null when not identified.

Bulk Email

Already have a list?

Verify a CSV or spreadsheet. Keep your original columns. Preview the result before you pay.

Verify a list

  1. Preview the result

    See how your addresses and original columns come together.

  2. Know the price

    Review the exact quote before paying for the file.

  3. Download and use it

    Take the results back into the workflow you already have.

Questions about email verification.

Using the API

Can I use this on my signup form?

Yes. Use a domain-restricted public key for address checks in your browser, or call the API from your server. Keep secret keys and mailbox verification on your server. The integration guides on this page include working examples.

What do address checks include?

Format, domain, consumer mailbox, role, disposable, reserved domain type, and a typo suggestion when we have one. Those ride the normal request pool.

Can I suggest an email correction?

A suggested address when the host is a known misspelling of a real mail host. gmal.com becomes gmail.com. Null when we have no suggestion. Never a guess, and never a local-part fix.

Which countries are supported?

Address checks work worldwide. Mailbox results depend on what the receiving mail system can confirm. A catchall domain or an unavailable answer can leave a mailbox unconfirmed.

Can I run a list?

Use Bulk Email to upload a CSV or spreadsheet. Preview the results, then see the exact price before you pay.

How is lookup data handled?

API usage records can include request paths and query parameters, including lookup inputs. Request records currently have no fixed automatic deletion period. Our Privacy Policy explains retention and how to request access or deletion.

Verification and cost

What does mailbox verification check?

Deliverable and catchall, a mailbox status and reason, and address details such as a suggested first name and mail provider. Unavailable details stay null. One unit from the monthly email allowance. Free includes 100 a month. See Plans for additional lookup rates.

What is a catchall?

A domain that accepts mail for any local part. Deep flags it so you can treat that inbox as unverified.

Does a valid address mean I can send?

valid describes the address format. Domain checks and mailbox verification add separate signals. A deliverable result does not guarantee inbox placement, consent, or that an address belongs to a particular person.

What if the mailbox check does not complete?

HTTP 200 with deliverable and catchall null. The unit is not billed. That is not a miss.

How fresh is a verification?

A lookup can reuse an earlier mailbox check. Deliverable results can be reused for 7 days, catchall results for 30 days, and undeliverable results for 90 days. A cached response can remain for up to another day.

How are API checks priced?

Address checks use your plan's API requests. Mailbox verification has its own monthly allowance, including 100 on Free. An incomplete mailbox check is not billed. Plans shows included quantities and additional lookup rates.

Have another question? Email us.