POST
https://spideriq.di-atomic.com
/
api
/
v1
/
jobs
/
spiderVerify
/
submit
Submit SpiderVerify Job
curl --request POST \
  --url https://spideriq.di-atomic.com/api/v1/jobs/spiderVerify/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "payload": {},
  "payload.email": "<string>",
  "payload.emails": [
    {}
  ],
  "payload.check_gravatar": true,
  "payload.check_dnsbl": true,
  "payload.smtp_timeout_secs": 123,
  "payload.fuzziq_enabled": true,
  "payload.fuzziq_unique_only": true,
  "priority": 123
}
'

​
Overview

SpiderVerify validates email addresses at the SMTP level to determine deliverability without sending actual emails. It can verify single emails or bulk batches of up to 100 emails per request.

​
Request Body

​
payload
object
required
Verification parameters
​
payload.email
string
Single email to verify. Either email or emails is required.
​
payload.emails
array
Array of emails to verify (max 100). Either email or emails is required.
​
payload.check_gravatar
boolean
default:"false"
Check if email has a Gravatar profile
​
payload.check_dnsbl
boolean
default:"false"
Check email domain against DNSBL blacklists
​
payload.smtp_timeout_secs
integer
default:"10"
SMTP connection timeout in seconds
​
payload.fuzziq_enabled
boolean
Enable FuzzIQ deduplication for this job (v2.18.0+)When enabled, each verified email will include a fuzziq_unique flag indicating whether it’s a new record or duplicate.Default: Uses client-level setting (typically true)
​
payload.fuzziq_unique_only
boolean
Return only unique records, filtering out duplicates (v2.18.0+)When true, emails that are duplicates of previously verified records will be excluded from the response.Default: Uses client-level setting (typically false)
​
priority
integer
default:"5"
Job priority (0-10, higher = processed first)

​
Single Email Verification

curl -X POST https://spideriq.di-atomic.com/api/v1/jobs/spiderVerify/submit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <client_id>:<api_key>:<api_secret>" \
  -d '{
    "payload": {
      "email": "john@example.com"
    },
    "priority": 5
  }'

​
Bulk Email Verification

Verify up to 100 emails in a single request: 
curl -X POST https://spideriq.di-atomic.com/api/v1/jobs/spiderVerify/submit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <client_id>:<api_key>:<api_secret>" \
  -d '{
    "payload": {
      "emails": [
        "john@example.com",
        "jane@company.com",
        "info@business.org"
      ]
    },
    "priority": 5
  }'

​
Response

​
Job Submitted Successfully

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "spiderVerify",
  "status": "queued",
  "created_at": "2025-12-22T10:30:00Z",
  "from_cache": false,
  "message": "Job submitted successfully and queued for processing"
}

​
Completed Job Result (Single Email)

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "spiderVerify",
  "status": "completed",
  "processing_time_seconds": 2.5,
  "worker_id": "spiderverify-llm5",
  "completed_at": "2025-12-22T10:30:02Z",
  "data": {
    "email": "john@example.com",
    "status": "valid",
    "quality_score": 95,
    "is_deliverable": true,
    "is_disposable": false,
    "is_role_account": false,
    "is_free": true,
    "is_catch_all": false,
    "domain": {
      "name": "example.com",
      "has_mx": true,
      "mx_records": ["mx.example.com"]
    },
    "smtp": {
      "can_connect": true,
      "is_catch_all": false
    }
  }
}

​
Completed Job Result (Bulk)

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "spiderVerify",
  "status": "completed",
  "processing_time_seconds": 8.2,
  "data": {
    "results": [
      {
        "email": "john@example.com",
        "status": "valid",
        "quality_score": 95,
        "is_deliverable": true
      },
      {
        "email": "jane@company.com",
        "status": "valid",
        "quality_score": 88,
        "is_deliverable": true
      },
      {
        "email": "fake@nonexistent.xyz",
        "status": "invalid",
        "quality_score": 0,
        "is_deliverable": false
      }
    ],
    "summary": {
      "total": 3,
      "valid": 2,
      "invalid": 1,
      "risky": 0,
      "unknown": 0
    }
  }
}

​
Status Values

StatusDescription
validEmail is deliverable
invalidEmail does not exist or is not deliverable
riskyEmail may be deliverable but has risk factors (catch-all, disposable)
unknownCould not determine status (timeout, greylisting)

​
Quality Score

The quality_score (0-100) indicates email quality:
ScoreMeaning
90-100Excellent - Verified deliverable
70-89Good - Likely deliverable
50-69Fair - Some risk factors present
25-49Poor - High risk
0-24Bad - Invalid or undeliverable

​
Boolean Flags

FlagDescription
is_deliverableEmail can receive messages
is_disposableTemporary/throwaway email service
is_role_accountGeneric role address (info@, support@)
is_freeFree email provider (Gmail, Yahoo, etc.)
is_catch_allDomain accepts all emails

​
Rate Limits

  • 3 seconds between verifications (automatic)
  • 100 emails maximum per bulk request
  • 5,000 jobs maximum queue depth
SpiderVerify uses email rotation across 10 VPS with 50 warmed emails to protect sender reputation.