Skip to main content

Batch Processing

Process large lists of leads efficiently with batch validation.

Overview​

Batch processing allows you to validate thousands of domains and emails in a single operation, making it ideal for:

  • Processing large lead lists
  • Cleaning marketing databases
  • Validating imported data
  • Scheduled re-validation

Using Batch API​

Single Batch Request​

Validate multiple domains in one API call:

curl -X POST https://api.status-check.io/v1/batch \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": [
      "example.com",
      "acme.org",
      "test-site.io"
    ]
  }'

Check Batch Status​

Monitor the progress of your batch job:

curl -X GET https://api.status-check.io/v1/batch/{job_id} \
  -H "X-API-Key: sk_your_api_key"

Response:

{
  "job_id": "batch_abc123",
  "status": "processing",
  "total": 1000,
  "processed": 450,
  "completed": 0,
  "progress": 45
}

CSV Upload​

For the easiest batch processing experience, use CSV upload via the dashboard:

  1. Prepare your CSV file
  2. Go to Leads page
  3. Click "Upload CSV"
  4. Select your file
  5. Validation starts automatically

Processing Time​

Typical processing times:

  • < 100 leads: Near instant
  • 100-1,000 leads: 1-2 minutes
  • 1,000-10,000 leads: 3-5 minutes
  • 10,000+ leads: 5-15 minutes

Rate Limits​

Batch processing is exempt from standard rate limits, but has its own limits:

  • Maximum batch size: 10,000 items
  • Concurrent batches: 3 per account
  • Daily limit: 100,000 validations

For larger volumes, contact support@status-check.io.

Best Practices​

  1. Break large lists into chunks - Process in batches of 5,000-10,000
  2. Monitor job status - Use the status endpoint to track progress
  3. Handle failures gracefully - Implement retry logic for failed items
  4. Use webhooks - Get notified when batches complete (coming soon)

Next Steps​

Support​

Questions about batch processing? Contact support@status-check.io