Skip to content

th0th/is-email-disposable

Repository files navigation

is-email-disposable

A REST API for checking if an e-mail address is disposable (a.k.a. throwaway).

Using the hosted version

WebGazer offers this as a publicly available service. You can freely use it on https://isemaildisposable.webgazer.io.

For example, a GET request to https://isemaildisposable.webgazer.io/?email=johndoe@getnada.com will return with this response:

{
  "isDisposable": true
}

You can send a full e-mail address or only the domain, too. If you don't set the email query parameter, you will get an HTTP 400 Bad Request response.

Deploying

The application is also available to be used as a docker image. You can deploy your own self-hosted version:

$ docker run -p 80:80 th0th/is-email-disposable

I found a new domain...

If you came across a new domain that is used a disposable e-mail address source, you can add it to domains.json in a pull request. Please mind that domains in this file are listed alphabetically.

Contribution

Even if this is a very simple application, if you have some kind of improvement idea, don't hesitate to create an issue. Or a PR would be even better :)

Shameless plug

I am an indie hacker, and I am running two services that might be useful for your business. Check them out :)

WebGazer

WebGazer

WebGazer is a monitoring service that checks your website, cron jobs, or scheduled tasks on a regular basis. It notifies you with instant alerts in case of a problem. That way, you have peace of mind about the status of your service without manually checking it.

PoeticMetric

PoeticMetric

PoeticMetric is a privacy-first, regulation-compliant, blazingly fast analytics tool.

No cookies or personal data collection. So you don't have to worry about cookie banners or GDPR, CCPA, and PECR compliance.

License

Copyright © 2020, Gökhan Sarı. Released under the MIT License.