Disposable Email Checker

Disposable Email Checking API

A simple POST to /api/tools/authenticity-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/authenticity-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/authenticity-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 (an integer from 0 to 100, directly comparable to the Authenticity scores in your dashboard) and any observations Dregs made about the profile data.

curl https://dregs.com/api/tools/authenticity-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,
  "authenticity": 73,
  "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.