Download bulk results
Export a bulk verification job as CSV, optionally filtered by verdict.
Streams the job's verified rows as a CSV attachment (verification_<segment>_<jobId>.csv). Use it to pull a clean send list (segment=valid) or a removal list (segment=invalid) straight into your ESP or CRM.
GET /v3/validate/bulk/{jobId}/download
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
jobId | string | Required | The job_id returned by POST /v3/validate/bulk. |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
segment | string | Optional | Only rows with this verdict: valid, invalid, catch_all, unknown or risky. Default all (every row). |
Responses
| Status | Description |
|---|---|
200 | OK. text/csv with 15 columns: email, result, sub_status, recommendation, confidence, reason, domain, mx_provider, is_disposable, is_role_address, is_free_provider, is_catch_all, mx_found, smtp_check, did_you_mean. |
401 | Missing or invalid API key. |
404 | No job with that id on your account. |
Code examples
cURL
curl https://api.wemail.io/v3/validate/bulk/{jobId}/download \
-H "Authorization: Bearer afn_live_…"Node.js
const res = await fetch("https://api.wemail.io/v3/validate/bulk/{jobId}/download", {
headers: {
Authorization: `Bearer ${process.env.WEMAIL_API_KEY}`,
},
});
const data = await res.json();Python
import os, requests
r = requests.get(
"https://api.wemail.io/v3/validate/bulk/{jobId}/download",
headers={"Authorization": f"Bearer {os.environ['WEMAIL_API_KEY']}"},
)
data = r.json()