Job Management
Docs index for AI agents: https://mailvalid.io/llms.txt. Every docs page is also available as Markdown: add
.mdto its URL.
List your bulk verification jobs, download their results, and cancel them. These read endpoints are free and count against the read rate limit, not the verification limit.
List your jobs
GET https://mailvalid.io/api/v1/verify/bulk
Returns a paginated list of all your bulk verification jobs.
| Parameter | Type | Default | Description |
|---|---|---|---|
page |
int | 1 | Page number |
page_size |
int | 20 | Items per page (max 100) |
status |
string | all | Filter by status |
curl "https://mailvalid.io/api/v1/verify/bulk?page=1&status=completed" \
-H "X-API-Key: mv_live_your_key_here"
Download results
GET https://mailvalid.io/api/v1/verify/bulk/{job_id}/download
Download verification results as JSON or CSV.
# Download as CSV
curl "https://mailvalid.io/api/v1/verify/bulk/{job_id}/download?format=csv" \
-H "X-API-Key: mv_live_your_key_here" \
-o results.csv
# Download as JSON
curl "https://mailvalid.io/api/v1/verify/bulk/{job_id}/download?format=json" \
-H "X-API-Key: mv_live_your_key_here" \
-o results.json
Cancel a job
DELETE https://mailvalid.io/api/v1/verify/bulk/{job_id}
Cancel a pending or processing job. Billable rows that already completed use credits. Unused reserved credits are released.
curl -X DELETE https://mailvalid.io/api/v1/verify/bulk/{job_id} \
-H "X-API-Key: mv_live_your_key_here"