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

# List Email Finder jobs

`GET /v1/email-finder/`

## Request

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

List the email finder jobs on your account, newest first, with each job's status and progress. Prospect results are not included: fetch one job with `GET /v1/email-finder/{job_id}/` for those.

Use `limit` and `offset` to page through them (25 per page by default). Reading the list is free.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- EmailFinderJobSummaryOut[]
  - `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 the job's prospects that have finished, from 0 to 100.
  - `prospect_count` integer, required: Number of prospects submitted.
  - `error_message` string: Job-level failure message. Empty when the job itself did not fail; a single prospect failing is reported on that prospect.
  - `job_type` string: Always `email_finder` for jobs created on this endpoint.

## 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)