API Documentation
Integrate BulkEmailVerification into your applications with our powerful REST API. Validate emails programmatically with enterprise-grade accuracy.
API Key Format
Your API Key is required to use our Email verification API. You can get your actual API key from your client dashboard after signing up.
⚠️ Replace "API_KEY" with your actual API key - Never share it with others.
� Get Your Real API Key: This is a demo API key for documentation purposes.
Login to Client Area → API Settings
to get your actual API key.
API - Validate Single Email
Validate individual email addresses in real-time using our single email validation endpoint.
Endpoint
GET
Example Request
curl "https://app.bulkemailverification.com/verifier/validate_single/support@bulkemailverification.com/API_KEY"
Example Response
{
"Address": "support@BulkEmailVerification.com",
"catch_all": "false",
"Status": "Valid",
"Disposable_Domain": "false",
"Role_Based": "true",
"Free_Domain": "false",
"Greylisted": "false",
"Diagnosis": "Mailbox Exists and Active"
}
Status: Valid, Invalid, Catch-all, or Unknown.
Disposable Domain: Indicates if the domain is disposable.
Free Domain: Indicates if the email is not a business address.
Greylisted: The server may not respond properly on the first attempt.
Diagnosis: Provides helpful information about Invalid addresses.
Disposable Domain: Indicates if the domain is disposable.
Free Domain: Indicates if the email is not a business address.
Greylisted: The server may not respond properly on the first attempt.
Diagnosis: Provides helpful information about Invalid addresses.
Rate Limit: 30 requests per minute
API - Get Credits
Check your available credits balance using this endpoint.
Endpoint
GET
Example Request
curl "https://app.bulkemailverification.com/verifier/getcredits/API_KEY"
Example Response
{
"credits": "7800"
}
API - Upload File for Bulk Verification
Upload TXT/CSV files for bulk email validation. Perfect for processing large email lists.
Endpoint
POST
POST Variables
api_key (string), filename (file upload)
Example Request
curl -F "filename=@/path/to/emails.txt" -F "api_key=API_KEY" "https://app.bulkemailverification.com/verifier/upload_file"
Example Response
{
"status": true,
"file_name": "emails.txt",
"file_id": 1670,
"msg": "File uploaded successfully."
}
API - Get File Info
Get file processing status, results, and download links for your uploaded files.
Endpoint
GET
Example Request
curl "https://app.bulkemailverification.com/verifier/file_info/API_KEY/1670"
Example Response
{
"upload_id": "1669",
"file_name": "test_20190909001723.xlsx",
"file_path": "https://app.bulkemailverification.com/downloadreport/csv/1669",
"xls_file_path": "https://app.bulkemailverification.com/downloadreport/xls/1669",
"user_id": "26",
"created_at": "2019-09-09 00:17:23",
"ready_for_download": "1",
"valid": "27",
"invalid": "2",
"catchall": 0,
"unknown": 0,
"duplicates": 0,
"spam_trap": 10,
"toxic_domains": 0,
"credit_used": "29",
"total": "31",
"status": "finished"
}