Disposable email domain validator

Why?

Use it to validate email addresses on sign up, or just to see how many real email addresses you have in your system.

Available in GitHub Maven package

<repository>
  <id>github</id>
  <name>GitHub Packages</name>
  <url>https://<github_user>:<github_personal_access_token>@maven.pkg.github.com/valarpirai/disposable-emails</url>
</repository>

<dependency>
  <groupId>org.valarpirai</groupId>
  <artifactId>disposable-email</artifactId>
  <version>{version}</version>
</dependency>

Usage

We are using an autogenerated list which is updated every 24 hours - https://github.com/disposable/disposable

Getting latest Domain list

This lib has a list of disposable email domains (encoded file) inside resources. The following method will download latest disposable email list from here and use it Note: In your application startup, you need to call this method to fetch updated domain list.

DisposableEmail.refreshDisposableDomains()

Get DNS and disposable details of a email domain

DisposableEmail.getDomainDetails("gmail.com")

{
  "DISPOSABLE_DOMAIN": false,
  "DNS_MX_PRESENT": true
}

DisposableEmail.getDomainDetails("yopmail.com")

{
  "DISPOSABLE_DOMAIN": true,
  "DNS_MX_PRESENT": true
}

DisposableEmail.getDomainDetails("nonexisting123.com")

{
  "DISPOSABLE_DOMAIN": false,
  "DNS_MX_PRESENT": false
}

Check whether a given email address is disposable address (local check)

DisposableEmail.isDisposable("hello@gmail.com") -> false
DisposableEmail.isDisposable("hello@mailsac.com") -> true

Disposable domain with valid DNS MX Record

DisposableEmail.hasValidMailDomain("hello@mailsac.com") -> true

Valid domain without DNS MX Record

DisposableEmail.hasValidMailDomain("god.com") -> false

Use different DNS resolver

DisposableEmail.hasValidMailDomain("hello@gmail.com", DnsResolverType.CLOUD_FLARE) -> true
DisposableEmail.hasValidMailDomain("hello@gmail.com", DnsResolverType.GOOGLE) -> true

Whitelist Domains

DisposableEmail.addDomainToWhitelist("mailsac.com")
DisposableEmail.isDisposable("hello@mailsac.com") -> false

DisposableEmail.removeDomainFromWhitelist("mailsac.com")
DisposableEmail.isDisposable("mailsac.com") -> true

Blacklist Domains

DisposableEmail.addDomainToBlacklist("gmail.com")
DisposableEmail.isDisposable("hello@gmail.com") -> true

DisposableEmail.removeDomainFromBlacklist("gmail.com")
DisposableEmail.isDisposable("gmail.com") -> true

How it works?