# Bulk Verification

Upload a CSV and create an asynchronous verification job with `POST /api/bulk`.

## Upload

```bash
curl -X POST https://verimails.com/api/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@leads.csv" \
  -F "email_column=Email Address"
```

The CSV should contain an email column. VeriMails also auto-detects common headers such as `email`, `Email Address`, `work_email`, `business_email`, and `contact_email`.

## Poll Status

```bash
curl https://verimails.com/api/bulk/123 \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Download Results

```bash
curl https://verimails.com/api/bulk/123/download \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o results.csv
```

The full download preserves the original CSV columns and appends `Safe to Send` with `Yes` or `No`.