website logo
⌘K
Email Verification API
API Overview
Authentication
Rate Limits
Response Headers
Response Codes
Reference
Code Examples
Data Privacy API
Data Privacy API Overview
Reference
Code Examples
Webhooks
Webhooks Overview
Retries and Errors
Managing Webhooks
Verifying Webhooks
Event Triggers
Docs powered by archbee 

Email Verification API

3min

mailfloss offers a simple API enabling you to thoroughly check and verify email addresses right at the point of entry into your system.

In addition to checking the syntax, the actual existence of an email address using MX records, and the Simple Mail Transfer Protocol (SMTP), detecting whether the requested mailbox is configured to catch all incoming email traffic, the mailfloss API also identifies role-based email addresses, email addresses from free email providers, and disposable domains.

Combined with typo checks, email address suggestions, and more, these structures will make it simple to automatically filter "real" customers from typos, spammers, abusers, and increase response and success rates of your email campaigns.

You can get all of this with a single API call like the following.

Shell
|
curl --request GET \
  --url 'https://api.mailfloss.com/verify?email={email_address}&api_key={api_key}'


Recommendations

Treat any timeouts as unknown, and if at point of entry, allow the result to pass. It is not uncommon for many smaller email hosts to take many seconds, and for this reason, the result may not come in a timely manner. Rather than force the user to wait, let them proceed. Pass a webhook URL to our batch-verify endpoint to avoid polling for results. This is more efficient. All API calls should be made server-side.

The publicly available API is in beta

The API is currently in beta and under active development. While we'll make every effort to maintain consistency, updates may contain breaking changes.



Updated 03 Mar 2023
Did this page help you?
Yes
No
NEXT
API Overview
Docs powered by archbee 
TABLE OF CONTENTS
Recommendations
The publicly available API is in beta