Disposable Email Checker

Disposable Email Checking API

A simple POST to /api/tools/identity-check backs the web form on this page, and you can call it directly too. Anonymous calls are straightforward but limited. Create a free Dregs account to unlock higher limits and more detailed scoring.

Anonymous

Calling the endpoint anonymously gives a simple boolean response, indicating whether or not the domain is known to Dregs to be a disposable email domain. Send either an email (a full address) or a domain (a bare domain) — whichever you have. The response echoes back the field that was checked.

curl https://dregs.com/api/tools/identity-check \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com"}'

# Response
{
  "input": {"email": "user@example.com"},
  "disposableEmailDomain": false
}

# Or check a bare domain
curl https://dregs.com/api/tools/identity-check \
  -H "Content-Type: application/json" \
  -d '{"domain":"mailinator.com"}'

# Response
{
  "input": {"domain": "mailinator.com"},
  "disposableEmailDomain": true
}

Authenticated

Calling the same endpoint with a Dregs account (a Bearer token with a secret key) accepts more fields in the payload and returns a more detailed response, including an overall Authenticity score and any observations Dregs made about the profile data.

curl https://dregs.com/api/tools/identity-check \
  -H "Authorization: Bearer $DREGS_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john@acme-corp.com",
    "firstName": "John",
    "lastName": "Doe",
    "organizationName": "Acme Corp"
  }'

# Response
{
  "input": { ... },
  "disposableEmailDomain": false,
  "score": {
    "category": "AUTHENTICITY",
    "value": 0.73,
    "confidence": 0.81
  },
  "observations": [
    {
      "category": "AUTHENTICITY",
      "id": "authenticity.disposable-email",
      "label": "Disposable Email",
      "value": 1.0,
      "confidence": 0.95,
      "explanation": "Email domain appears legitimate",
      "metadata": { ... }
    }
  ]
}

Your secret key for making authenticated requests lives in Settings → Credentials in your Dregs dashboard. Treat it like a secure password and never put it in client-side code or commit it to version control.