Single Email Verification
POST /v1/verify/single
curl -X POST https://ev.ecomtechbd.com/v1/verify/single \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com"}'
# Response (HTTP 200)
{
"email": "user@example.com",
"valid": true,
"deliverable": true,
"risk_level": "low",
"provider": "example.com",
"response_time": 0,
"confidence": 95,
"details": {
"syntax_valid": true,
"domain_exists": true,
"mx_record": true,
"smtp_valid": true
},
"reason": "accepted_email",
"cached": false
}
Bulk Email Verification
POST /v1/verify/bulk — Smart routing: ≤10 emails return instant results, >10 emails return a job_id for async polling.
# Submit bulk verification
curl -X POST https://ev.ecomtechbd.com/v1/verify/bulk \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"emails": ["alice@example.com", "bob@company.org", "test@temp-mail.io"]
}'
# Instant response (≤10 emails, HTTP 200)
{
"success": true,
"instant": true,
"job_id": "69c361dbcdc4a8579ef3710b",
"status": "completed",
"total_emails": 3,
"valid_emails": 3,
"invalid_format_emails": 0,
"results": [
{
"email": "alice@example.com",
"valid": true,
"deliverable": true,
"risk_level": "low",
"reason": "accepted_email",
"cached": false
}
],
"summary": { "total": 3, "valid": 2, "invalid": 1 },
"message": "Verification completed instantly."
}
# Queued response (>10 emails, HTTP 200)
{
"success": true,
"job_id": "69712f9d04ae85a1dcf8724b",
"status": "queued",
"total_emails": 50,
"valid_emails": 50,
"invalid_format_emails": 0,
"estimated_time": "2 seconds",
"message": "Bulk verification queued with priority. Use /verify/bulk/status/{job_id} to check progress."
}
Check Job Status & Download Results
GET /v1/verify/bulk/status/:jobId — Poll for progress and results of queued bulk jobs.
# Check bulk job status
curl https://ev.ecomtechbd.com/v1/verify/bulk/status/JOB_ID \
-H "Authorization: Bearer YOUR_API_KEY"
# Response (completed)
{
"success": true,
"status": "completed",
"progress": 100,
"data": {
"results": [
{
"email": "alice@example.com",
"valid": true,
"deliverable": true,
"risk_level": "low",
"reason": "accepted_email",
"cached": false
}
],
"summary": {
"total": 50, "valid": 45, "invalid": 3, "unknown": 2, "failed": 0
},
"completed_at": "2026-03-25T10:30:00Z"
}
}
# Download results as CSV
curl https://ev.ecomtechbd.com/v1/verify/bulk/download/JOB_ID \
-H "Authorization: Bearer YOUR_API_KEY" \
-o results.csv