---
title: "List email searches"
method: GET
path: "/tools/find/email"
tags: ["Enrichment tools"]
---

# List email searches

`GET /tools/find/email`

## Request

- Base URL: `https://api.emelia.io`
- URL: `https://api.emelia.io/tools/find/email`
- Auth: API key in header `Authorization`

History of your single email searches, newest first. `page` is one based.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Success.

- object
  - `success` unknown
  - `data` EmailFinderJob[]
    - `_id` string: MongoDB ObjectId: 24 hexadecimal characters.
    - `fullname` string
    - `companyName` string
    - `companyWebsite` string
    - `status` 'running' | 'done' | 'error'
    - `email` string: Found email, absent when nothing was found.
    - `qualification` string: Qualification returned by the provider for the found email. `invalid` with no email when nothing was found or after a timeout.
    - `fallbackFound` boolean: True when the email was found by the second pass (company name only, used when the domain pass found nothing).
    - `date` string, date-time
  - `total` integer
  - `page` integer
  - `pageSize` integer

## Other responses

- `400`: Invalid request or business error (the API also uses 400 for "not found").
- `401`: Missing, malformed, unknown or disabled API key. The key must be exactly 48 characters, otherwise it is treated as a session token and rejected the same way.

---

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