# Job Management

> Docs index for AI agents: [https://mailvalid.io/llms.txt](https://mailvalid.io/llms.txt). Every docs page is also available as Markdown: add `.md` to its URL.

List your [bulk verification](https://mailvalid.io/docs/verify-bulk) 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 |

```bash
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.

```bash
# 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.

```bash
curl -X DELETE https://mailvalid.io/api/v1/verify/bulk/{job_id} \
  -H "X-API-Key: mv_live_your_key_here"
```