---
title: "List email validation jobs"
method: GET
path: "/v1/email-validation/"
tags: ["Email Verifier"]
---

# List email validation jobs

`GET /v1/email-validation/`

## Request

- Base URL: `https://api.evaboot.com`
- URL: `https://api.evaboot.com/v1/email-validation/`
- Auth: HTTP bearer

List the bulk email-verification jobs on your account, newest first, each with its status, progress and number of addresses. Per-address results are not included: fetch one job with `GET /v1/email-validation/{job_id}/` for those.

Synchronous and free: listing jobs costs no credits. Use `limit` (25 by default) and `offset` to page through the history. Addresses verified one at a time do not create a job and so never appear here.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- EmailValidationJobSummaryOut[]
  - `id` string, required: Identifier of the job, as returned when you created it.
  - `status` string, required: Job status: `pending`, `running`, `complete` or `failed`.
  - `created_at` string, required: When the job was created.
  - `updated_at` string, required: When the job last changed.
  - `progress` integer: Percentage of addresses processed, from 0 to 100.
  - `prospect_count` integer, required: Number of addresses submitted.
  - `error_message` string: Why the job failed. Empty when it completed normally.
  - `job_type` string: Always `email_validation` for jobs created here.

## Other responses

- `401`: The API key is missing, malformed or unknown.
- `422`: The request body or a supplied URL failed validation.

---

[API](https://skmtc.dev/evaboot/apis/evaboot-public-api.md) · [All operations](https://skmtc.dev/evaboot/apis/evaboot-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/evaboot/apis/evaboot-public-api/revisions/d770494f2718?raw)