Bulk jobs

Bulk jobs verify many addresses asynchronously. The flow is: create a job → add addresses → poll status → download results.

Create a job
```
POST /v1/bulk
```
Terminal window
curl -X POST https://api.verifymaill.com/v1/bulk \ -H "Authorization: Bearer sk_your_api_key" \ -H "Content-Type: application/json" \ -d '{"name":"june-newsletter","emails":["a@example.com","b@example.com"]}'
const res = await fetch("https://api.verifymaill.com/v1/bulk", { method: "POST", headers: { Authorization: `Bearer ${process.env.VERIFYMAIL_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ name: "june-newsletter", emails: ["a@example.com", "b@example.com"], }), }); const { id } = await res.json();
import os, requests res = requests.post( "https://api.verifymaill.com/v1/bulk", headers={"Authorization": f"Bearer {os.environ['VERIFYMAIL_API_KEY']}"}, json={"name": "june-newsletter", "emails": ["a@example.com", "b@example.com"]}, ) job_id = res.json()["id"]
Returns a job id and a status of queued.

Poll the job status

GET /v1/bulk/{id}

{
  "id": "job_abc123",
  "name": "june-newsletter",
  "status": "processing",
  "total": 2,
  "completed": 1,
  "progress": 0.5
}

Poll until status is complete. Status values: queued, processing, complete, failed.

Download the results
```
GET /v1/bulk/{id}/results
```
Returns one result object per address (same fields as the single verify response), or a downloadable file.