curl -X POST https://api.bouncelayer.com/v1/verify/bulk \
-H "X-API-Key: bl_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"emails": [
"sarah@acme.com",
"john@initech.org",
"burner@mailinator.com"
],
"webhook_url": "https://your-domain.com/webhooks/bouncelayer"
}'
curl -X POST https://api.bouncelayer.com/v1/verify/bulk \
-H "X-API-Key: bl_live_your_api_key_here" \
-F "file=@leads.csv" \
-F "webhook_url=https://your-domain.com/webhooks/bouncelayer"
{
"success": true,
"job_id": "01923a1f-829d-7b20-91fc-982348a201b9",
"status": "processing",
"total_emails": 15000,
"credits_reserved": 15000,
"created_at": "2026-10-24T10:12:00Z"
}
curl https://api.bouncelayer.com/v1/verify/bulk/01923a1f-829d-7b20-91fc-982348a201b9 \
-H "X-API-Key: bl_live_your_api_key_here"
{
"job_id": "01923a1f-829d-7b20-91fc-982348a201b9",
"status": "processing",
"progress_percent": 68.4,
"total_emails": 15000,
"processed_emails": 10260,
"valid_count": 9480,
"invalid_count": 520,
"catch_all_count": 180,
"disposable_count": 80,
"credits_used": 10260
}
If you uploaded an incorrect file or wish to stop an active queue, invoke the cancel endpoint. Remaining unverified credits are instantly refunded to your active balance:
curl -X POST https://api.bouncelayer.com/v1/verify/bulk/01923a1f-829d-7b20-91fc-982348a201b9/cancel \
-H "X-API-Key: bl_live_your_api_key_here"
{
"success": true,
"job_id": "01923a1f-829d-7b20-91fc-982348a201b9",
"status": "cancelled",
"processed_emails": 10260,
"unverified_emails_refunded": 4740
}