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

Bulk Validations

Need a simple, efficient method to perform email validations on a large scale quickly? Welcome to Bulk Validations!

Our Bulk Validation feature provides a simple, easy-to-follow set of steps for validating a large number of email addresses and retrieving the results quickly. From there, you can take proactive steps to protect the reputations of your sending domain(s) and your assigned IPs by removing the invalid email addresses from your mailing lists or contacts. This due diligence, in turn, aids in maintaining an excellent quality of recipients, as well as minimizing bounce and suppression events. We're all about optimizing your sending to help enable the full range of your success!

How to Use the Bulk Validation API & Retrieve the Results

If utilizing the Bulk Validations feature via the Email Validations API, the steps are as follows:

  1. Create a mailing list and upload members; take note of its alias.
  2. Submit a POST to the API URL which contains the alias from step 1 (more on this step below).
  3. Periodically submit a GET to the same URL to retrieve the download links for the CSV and JSON files.

If utilizing the Control Panel, we'll show you how to do this below:

  1. First, log in to the Mailgun Control Panel (if you have not already done so).
  2. Then, within the left-hand navigation pane, click the Sending option to expand its list of suboptions.
  3. Next, click the Mailing lists suboption and select the intended mailing list.
  4. In the Details section and next to the Validate recipient addresses setting, click the Begin validation button and confirm the intention to perform the validation by clicking Begin

Keep in mind - these validations take some processing time! You'll see the display demonstrating the validations as being in progress. Once complete, just click the Download validations result button.

API Endpoints for Bulk Validations

POST - API command used to Submit Job  

URL: https://api.mailgun.net/v3/lists/listalias@yourdomainhere.tld/validate

GET - API command used to Gather Job Status

URL: https://api.mailgun.net/v3/lists/listalias@yourdomainhere.tld/validate

DELETE - API command used to Cancel Job

URL: https://api.mailgun.net/v3/lists/listalias@yourdomainhere.tld/validate

Things to Keep in Mind

For successful implementation with your particular use case, make sure to remember the following:

  • Only one job can be processed per account at any given time
  • The processing rate of lists can vary depending on list size and system load

Highlights & Features

In summary, here's the of options Bulk Validations provides for you:

  • Perform a list-based validation much faster than can be done one-by-one
  • Both CSV and JSON versions of processed email addresses available
  • Perpetually retrievable and parseable
  • Only three new simple sets of APIs that anyone already oriented with Mailgun's architecture can quickly and readily adopt
  • Existing Mailing Lists uploaded to your Mailgun account are readily able to use - right away

Got Questions?

Sinch Mailgun 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!