Skip to content
MailVet
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.csv

Columns added to CSV downloads

ColumnValues
mailvet_resultdeliverable, undeliverable, risky, unknown
mailvet_reasonReason code, see /email-verification-statuses
mailvet_score0–100
mailvet_catch_all_domaintrue / false
mailvet_roletrue / false
mailvet_disposabletrue / false
mailvet_free_providertrue / false

Retention

Job files and results are deleted 30 days after the job finishes. DELETE /v1/bulk/{id} removes them immediately.