---
title: "List email verification jobs"
method: GET
path: "/email-verification/jobs"
tags: ["Email Verification"]
---

# List email verification jobs

`GET /email-verification/jobs`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/email-verification/jobs`
- Auth: HTTP bearer

Returns the workspace's standalone verification jobs, newest first, with live counts and what each has billed.

## Query parameters

- `page` integer
- `size` integer
- `search` string

## Response `200`

A page of jobs

- ModelsListEmailVerificationJobsResponse
  - `count` integer
  - `next` boolean
  - `results` ModelsEmailVerificationJobResponse[]
    - `catchall` integer: Catchall accepts everything at the domain, so deliverability is likely but not proven.
    - `end_time` string: EndTime in RFC3339, zero while the job is still running.
    - `error_code` string: ErrorCode is empty on a healthy job. monthly_limit_reached means the allowance ran out and the remaining addresses came back unknown rather than missing; they are still in the download, marked.
    - `id` string
    - `invalid` integer: Invalid will bounce.
    - `meter_events` integer: MeterEvents is what the job has billed so far. Every check runs up to two providers and each one that answers is one event, so an address costs one event or two.
    - `name` string: Name the job was created with.
    - `processed` integer: Processed is how many have a verdict yet.
    - `spent_usd` number: SpentUsd is MeterEvents priced at the meter rate: what this job adds to the invoice, not an estimate.
    - `start_time` string: StartTime in RFC3339.
    - `state` string: State is pending, running, done, failed or canceled.
    - `total` integer: Total addresses in the job.
    - `unknown` integer: Unknown got no verdict, so it was NOT billed. Usually a provider failure or the workspace's monthly verification allowance running out mid-job, in which case error_code says which.
    - `valid` integer: Valid is deliverable.

## Other responses

- `401`: Unauthorized - invalid or missing API key
- `500`: Failed to list jobs

---

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