Sniffmail API

Authorization: Bearer sniff_your_api_key_here

x-api-key: sniff_your_api_key_here

https://api.sniffmail.io

curl -X POST https://api.sniffmail.io/verify \
  -H "Authorization: Bearer sniff_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

const response = await fetch('https://api.sniffmail.io/verify', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sniff_your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ email: 'test@example.com' }),
});

const result = await response.json();
console.log(result);

import requests

response = requests.post(
    'https://api.sniffmail.io/verify',
    headers={'Authorization': 'Bearer sniff_your_api_key'},
    json={'email': 'test@example.com'}
)

print(response.json())

curl -X POST https://api.sniffmail.io/jobs \
  -H "Authorization: Bearer sniff_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": ["user1@example.com", "user2@example.com", "user3@example.com"],
    "webhookUrl": "https://yoursite.com/webhook"
  }'

{
  "jobId": "job_abc123xyz",
  "status": "pending",
  "totalEmails": 3,
  "message": "Job created successfully"
}

curl https://api.sniffmail.io/jobs/job_abc123xyz \
  -H "Authorization: Bearer sniff_your_api_key"

{
  "id": "job_abc123xyz",
  "status": "completed",
  "totalEmails": 3,
  "processedEmails": 3,
  "validEmails": 2,
  "invalidEmails": 1,
  "progress": 100,
  "createdAt": "2024-01-15T10:30:00Z",
  "completedAt": "2024-01-15T10:30:45Z"
}

{
  "id": "job_abc123xyz",
  "totalEmails": 3,
  "validEmails": 2,
  "invalidEmails": 1,
  "results": [
    { "email": "user1@example.com", "status": "valid", "isDeliverable": true, "isDisposable": false },
    { "email": "user2@example.com", "status": "valid", "isDeliverable": true, "isDisposable": false },
    { "email": "user3@tempmail.com", "status": "risky", "isDeliverable": true, "isDisposable": true }
  ]
}

curl -X POST https://api.sniffmail.io/jobs/webhooks \
  -H "Authorization: Bearer sniff_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yoursite.com/sniffmail-webhook",
    "events": ["job.completed"]
  }'

{
  "id": "wh_xyz789",
  "secret": "whsec_abc123...",
  "message": "Save this secret - it won't be shown again"
}

{
  "event": "job.completed",
  "jobId": "job_abc123xyz",
  "status": "completed",
  "totalEmails": 100,
  "validEmails": 85,
  "invalidEmails": 15,
  "completedAt": "2024-01-15T10:30:45Z"
}

import crypto from 'crypto';

function verifyWebhook(payload: string, signature: string, secret: string): boolean {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}

// In your webhook handler:
app.post('/sniffmail-webhook', (req, res) => {
  const signature = req.headers['x-sniffmail-signature'];
  const isValid = verifyWebhook(JSON.stringify(req.body), signature, WEBHOOK_SECRET);

  if (!isValid) {
    return res.status(401).send('Invalid signature');
  }

  // Process the webhook...
  res.status(200).send('OK');
});

// Zapier returns these fields you can use in subsequent steps:
{
  "email": "user@example.com",
  "result": "safe",           // safe, risky, invalid, unknown, unverified
  "is_valid": true,
  "is_deliverable": true,
  "is_disposable": false,
  "is_role_account": false,
  "reason": "Valid email"
}

// Trigger payload when a job completes:
{
  "id": "job_abc123xyz",
  "status": "completed",
  "total_emails": 100,
  "valid_emails": 85,
  "invalid_emails": 15,
  "completed_at": "2024-01-15T10:30:45Z"
}

{
  "email": "test@example.com",
  "is_valid": true,
  "is_reachable": "safe",
  "is_disposable": false,
  "is_role_account": false,
  "is_deliverable": true,
  "mx_valid": true,
  "reason": "Valid email"
}

{
  "error": "Validation Error",
  "message": "Invalid email format"
}

npm install sniffmail

import { configure, validateEmail } from 'sniffmail';

// Configure your API key (get one free at sniffmail.io)
configure({
  apiKey: process.env.SNIFFMAIL_API_KEY,
});

// Validate with SMTP verification (requires paid plan)
const result = await validateEmail('user@example.com', { deep: true });

if (!result.valid) {
  console.log(`Invalid: ${result.reason}`);
  // 'invalid_syntax' | 'disposable' | 'no_mx_records' | 'mailbox_not_found'
}

import { isDisposableDomain } from 'sniffmail';

// Instant check against 10,000+ disposable domains
if (isDisposableDomain('tempmail.com')) {
  console.log('Blocked!');
}

import { validateEmails } from 'sniffmail';

const { results, summary } = await validateEmails(
  ['a@gmail.com', 'b@tempmail.com', 'c@company.com'],
  { deep: true, concurrency: 5 }
);

console.log(summary);
// { total: 3, valid: 2, invalid: 0, disposable: 1, unknown: 0 }