Skip to main content

RESTFul API

fakefilter providers a RESTFul API for isFakeDomain and isFakeEmail functionalities. The queries are more recent than offline versions but we do not provide any reliability of our backend. You may want to try..catch and use offline versions in case our endpoint is down

API​

GET /api/ping​

Use this endpoint to see if our backend is ready

curl https://fakefilter.net/api/ping
{
  "retcode": 200,
  "message": "pong"
}

GET /api/is/fakedomain/:domain​

curl https://fakefilter.net/api/is/fakedomain/fakefilter.net
{
  "retcode": 200,
  "isFakeDomain": false,
  "details": null
}

curl https://fakefilter.net/api/is/fakedomain/10minmail.de
{
  "retcode": 200,
  "isFakeDomain": "10minmail.de",
  "details": {
    "provider": "muellmail.com",
    "firstseen": 1646140000,
    "lastseen": 1646140000,
    "randomSubdomain": false
  }
}

GET /api/is/fakeemail/:email​

curl https://fakefilter.net/api/is/fakeemail/[email protected]
{
  "retcode": 200,
  "isFakeEmail": false,
  "details": null
}

curl https://fakefilter.net/api/is/fakeemail/10minmail.de
{
  "retcode": 200,
  "isFakeEmail": "10minmail.de",
  "details": {
    "provider": "muellmail.com",
    "firstseen": 1646140000,
    "lastseen": 1646140000,
    "randomSubdomain": false
  }
}