Updated November 13, 2026
Bulk lists
Verify a whole list in one job: upload a file or send a JSON array, watch progress, download results filtered by result.
Create a job
Multipart upload of a CSV or XLSX (up to 1,000,000 rows), or JSON { "emails": [...] }. Duplicates and invalid syntax are removed before verification and never charged.
POST /v1/bulk
curl https://api.mailvet.app/v1/bulk \
-H "Authorization: Bearer mv_live_…" \
-F "file=@leads.csv" \
-F "email_column=email" \
-F "webhook_url=https://example.com/hooks/mailvet"Job created
201 Created
{
"id": "blk_01JD9A4ZK2",
"status": "queued",
"total": 48210,
"duplicates_removed": 1132,
"syntax_invalid": 214,
"created_at": "2026-11-13T09:41:07Z"
}Track progress
status moves through queued, running and done. Counts update as rows finish.
GET /v1/bulk/{id}
curl https://api.mailvet.app/v1/bulk/blk_01JD9A4ZK2 \
-H "Authorization: Bearer mv_live_…"
{
"id": "blk_01JD9A4ZK2",
"status": "running",
"total": 48210,
"processed": 31877,
"counts": { "deliverable": 24102, "undeliverable": 5391, "risky": 1840, "unknown": 544 },
"credits_charged": 31333
}Download results
format is csv or json. Filter with result=deliverable, result=deliverable,risky, or leave it off for every row. Your original columns come back unchanged with result columns appended.
GET /v1/bulk/{id}/results
curl "https://api.mailvet.app/v1/bulk/blk_01JD9A4ZK2/results?format=csv&result=deliverable" \
-H "Authorization: Bearer mv_live_…" \
-o deliverable.csvColumns added to CSV downloads
| Column | Values |
|---|---|
| mailvet_result | deliverable, undeliverable, risky, unknown |
| mailvet_reason | Reason code, see /email-verification-statuses |
| mailvet_score | 0–100 |
| mailvet_catch_all_domain | true / false |
| mailvet_role | true / false |
| mailvet_disposable | true / false |
| mailvet_free_provider | true / false |
Retention
Job files and results are deleted 30 days after the job finishes. DELETE /v1/bulk/{id} removes them immediately.