RocketVerifier Documentation

POST/v1/verify/batch

Verify multiple email addresses in a single request. Perfect for processing large lists efficiently with real-time progress tracking.

How Batch Verification Works

Submit Job

Upload your email list

Processing

We verify all emails

Results

Download or receive webhook

Max Emails

1,000,000

Credits

1 per email

Processing

~500/min

Retention

30 days

Create a Batch Job

cURL

curl -X POST https://api.rocketverifier.com/v1/verify/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Email List",
    "emails": [
      "user1@example.com",
      "user2@example.com",
      "user3@example.com"
    ],
    "webhook_url": "https://yoursite.com/webhooks/rocketverifier"
  }'

Request Body

Parameter	Type	Required	Description
emails	array	Required	Array of email addresses to verify
name	string	Optional	Friendly name for the job
webhook_url	string	Optional	URL to receive completion notification
callback_data	object	Optional	Custom data to include in webhook

Response

201 Created

{
  "id": "job_abc123xyz",
  "name": "My Email List",
  "status": "pending",
  "total_emails": 3,
  "processed_emails": 0,
  "created_at": "2024-01-15T10:30:00Z",
  "estimated_completion": "2024-01-15T10:35:00Z"
}

Check Job Status

GET/v1/verify/batch/:job_id

curl https://api.rocketverifier.com/v1/verify/batch/job_abc123xyz \
  -H "Authorization: Bearer YOUR_API_KEY"

200 OK

{
  "id": "job_abc123xyz",
  "name": "My Email List",
  "status": "completed",
  "total_emails": 3,
  "processed_emails": 3,
  "valid_count": 2,
  "invalid_count": 1,
  "risky_count": 0,
  "download_url": "https://api.rocketverifier.com/v1/jobs/job_abc123xyz/download",
  "created_at": "2024-01-15T10:30:00Z",
  "completed_at": "2024-01-15T10:32:15Z"
}

Job Statuses

pending

Job queued for processing

processing

Verification in progress

completed

All emails verified

failed

Job failed (see error)

Webhooks

Get notified when jobs complete

Single Verification

Verify emails one at a time