API to check if an email is from a disposable email service
yarn install
or npm install
This will also download the latest domain list
yarn start
or npm run start
Endpoint will be available on localhost:3000/check/:email
Quick use: curl http://localhost:3000/check/[email protected]
will return {"disposable": true}
To re-fetch the domain list run yarn postinstall
or npm run postinstall
- this can be done via a cronjob every 2 days to keep the domain list updated
To enable authentication with header X-API-Key
you need to clone the .env.example
to .env
, change API_KEY_LIST
and uncomment src/app.js L15-L23
cp .env.example .env
yarn test
or npm run test
Tests can be found in test/test.js
, using Tape + Supertest
Domain list is loaded from yzyjim/disposable-email-domain-list