We're experiencing difficulty. Our engineers are on it. Please check status.mailgun.com for real-time updates.

Getting Started with Email Verifications

Getting Started

So you've decided to take the step to implement our Email Verification API. A good place to get started is to test the Email Verification API in the Mailgun Control Panel.  This way, you can quickly and easily submit verification and view the JSON response from the API. 

If your account has it, the Verifications option will be on the left-hand navigation pane of your Control Panel.

Deciphering The Clues

So, once you've verified an address, what does the response mean? Let's take a look at the parameters in the JSON response. 

  • address - Address being verified
  • did_you_mean - A suggested alternatively based on common misspellings or typos
  • is_disposable_address - Returns true if the domain is a known disposable email address
  • is_role_address - Returns true if the address is role-based, e.g. support@example.com or info@example.com
  • is_valid - Checks the email against known provider rule list and returns false if a violation occurs
  • mailbox_verification - Result of the mailbox verification check with the ESP. Does not affect is_valid
  • parts - Parsed segments of the email address
  • reason - Reason for address failing email verification check if applicable 

Other Helps For Your Journey

We also have community-driven SDKs for popular programming languages to help you implement Mailgun Email Verification into your project. 

You are now ready to begin making API calls to start verifying email addresses. To see the full technical details on how to implement and make calls to the Email Verification API, please see our technical documentation here

Got Questions?

Mailgun by Sinch has answers! If you have any concerns or questions, please send us a Support ticket using the Support page within your Mailgun Control Panel.  Our Support Team will be happy to assist!