📨 ValidEmail Bulk API Tutorial

1. Submit Bulk Emails for Verification

POST /v1/bulk

Submit up to 40,000 emails for async verification. Supports application/json or multipart/form-data.

📤 JSON Format

{
  "key": "YOUR_API_KEY",
  "emails": "user1@example.com,user2@example.com",
  "listName": "MyBulkList"
}

📤 Form Data Format

• key: Your API key
• emails: Comma-separated emails
• listName: Friendly name for the list

✅ Success Response

{
  "message": "Bulk request accepted",
  "bulkId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

💡 Save the bulkId to check status and download results.

2. Check Bulk Status

GET /v1/bulk/status

Check processing progress using your bulkId and API key.

📥 Request Format

GET https://api.validemail.net/v1/bulk/status?id=YOUR_BULK_ID&key=YOUR_API_KEY

✅ Response: Batch Processing

{
  "message": "Your batch is being processed.",
  "processed": 25000,
  "total": 40000
}

✅ Response: Batch Completed

{
  "message": "Your batch has been processed successfully.",
  "processed": 40000,
  "total": 40000
}

3. Download Result CSV

GET /v1/bulk/downloadcsv

Download the final results of your bulk verification as a CSV file.

📥 Request Format

GET https://api.validemail.net/v1/bulk/downloadcsv?id=YOUR_BULK_ID&key=YOUR_API_KEY

📁 File will be named like bulk_<GUID>.csv and will download automatically.

4. Get Credits Balance

GET /v1/bulk/balance

Retrieve the remaining email verification credits linked to your API key.

📥 Request Format

GET https://api.validemail.net/v1/bulk/balance?key=YOUR_API_KEY

✅ Response

{
  "balance": 1234
}