AntiTempMail Skill#

Validate email addresses to detect temporary/disposable email providers. Protect your services from throwaway accounts.

Setup#

Set your API key as an environment variable:

bash

export ANTITEMPMAIL_API_KEY="your_api_key_here"

Get your API key from: https://antitempmail.com/dashboard

Commands#

Check Single Email#

bash

curl -X POST https://antitempmail.com/api/v1/email/check \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ANTITEMPMAIL_API_KEY" \
  -d '{"email": "test@tempmail.com"}'

Response:

json

{
  "email": "test@tempmail.com",
  "isTemporary": true,
  "domain": "tempmail.com",
  "provider": "TempMail",
  "risk": "high"
}

Check Multiple Emails (Bulk)#

bash

curl -X POST https://antitempmail.com/api/v1/email/check/bulk \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ANTITEMPMAIL_API_KEY" \
  -d '{
    "emails": [
      "user1@gmail.com",
      "user2@tempmail.com",
      "user3@10minutemail.com"
    ]
  }'

Response:

json

{
  "results": [
    {
      "email": "user1@gmail.com",
      "isTemporary": false,
      "domain": "gmail.com",
      "risk": "low"
    },
    {
      "email": "user2@tempmail.com",
      "isTemporary": true,
      "domain": "tempmail.com",
      "provider": "TempMail",
      "risk": "high"
    },
    {
      "email": "user3@10minutemail.com",
      "isTemporary": true,
      "domain": "10minutemail.com",
      "provider": "10MinuteMail",
      "risk": "high"
    }
  ],
  "summary": {
    "total": 3,
    "temporary": 2,
    "legitimate": 1
  }
}

Usage Examples#

Validate User Registration#

When a user signs up, check if their email is temporary:

bash

EMAIL="newuser@example.com"
RESULT=$(curl -s -X POST https://antitempmail.com/api/v1/email/check \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ANTITEMPMAIL_API_KEY" \
  -d "{\"email\": \"$EMAIL\"}")

IS_TEMP=$(echo $RESULT | jq -r '.isTemporary')

if [ "$IS_TEMP" = "true" ]; then
  echo "⚠️  Temporary email detected! Registration blocked."
else
  echo "✅ Valid email. Proceeding with registration."
fi

Clean Email List#

Filter out temporary emails from a list:

bash

# Read emails from file (one per line)
EMAILS=$(cat email_list.txt | jq -R . | jq -s .)

curl -X POST https://antitempmail.com/api/v1/email/check/bulk \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ANTITEMPMAIL_API_KEY" \
  -d "{\"emails\": $EMAILS}" | \
  jq '.results[] | select(.isTemporary == false) | .email'

Response Fields#

• email: The validated email address
• isTemporary: Boolean indicating if it's a temporary email
• domain: Email domain
• provider: Name of the temporary email provider (if detected)
• risk: Risk level ( low, medium, high)
• confidence: Detection confidence score (0-100)

Error Handling#

Common errors:

• 401 Unauthorized: Invalid or missing API key
• 429 Too Many Requests: Rate limit exceeded
• 400 Bad Request: Invalid email format

Rate Limits#

• Free tier: 100 requests/day
• Pro tier: 10,000 requests/day
• Enterprise: Custom limits

Check your usage at: https://antitempmail.com/dashboard/credits

Notes#

• API responses are cached for 24 hours
• Bulk endpoint supports up to 100 emails per request
• All requests are logged for security and analytics