Bulk Email Verification

Docs index for AI agents: https://mailvalid.io/llms.txt. Every docs page is also available as Markdown: add .md to its URL.

Verify up to 10,000 emails in a single request. Jobs run asynchronously: poll for status, or get a webhook when the job completes.

POST https://mailvalid.io/api/v1/verify/bulk

Request body

Submit a bulk job

curl -X POST https://mailvalid.io/api/v1/verify/bulk \
  -H "X-API-Key: mv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      "john@company.com",
      "jane@example.org",
      "info@business.net"
    ],
    "webhook_url": "https://yourapp.com/webhooks/mailvalid"
  }'

Response (job created)

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "total_emails": 3,
  "credits_reserved": 3,
  "webhook_url": "https://yourapp.com/webhooks/mailvalid"
}

credits_reserved is the maximum possible charge and is reserved at submit time. Unused credits are released after processing. The final charge is returned as credits_used when the job completes.

Check job status

curl https://mailvalid.io/api/v1/verify/bulk/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: mv_live_your_key_here"

Completed job response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "total_emails": 3,
  "processed_emails": 3,
  "valid_count": 2,
  "invalid_count": 1,
  "credits_used": 3,
  "results": [
    {
      "email": "john@company.com",
      "status": "valid",
      "is_valid": true
    }
  ]
}

Each entry in results has the same fields as a single verification result.

Limits

Free accounts can submit up to 100 emails per bulk job. Every paid plan can submit up to 10,000. See Rate limits.

Related

• Job management: list, download and cancel jobs
• Webhooks: get notified when a job completes