# Email Finder

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/email/finder` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/email-finder |

## Description

Find verified professional email addresses by combining a person's full name with their company domain or company name.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/email/finder' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Find email for Anthony Dupont at piloterr.com

```json
{
  "email": "anthony.dupont@piloterr.com",
  "status": "valid",
  "last_name": "anthony",
  "first_name": "dupont",
  "company_domain": "piloterr.com"
}
```

## Documentation

## Overview
The Email Finder endpoint discovers professional email addresses by cross-referencing a person's full name with their company domain or company name. It returns a verified email address along with the confidence status.

## Quickstart
```
GET https://api.piloterr.com/v2/email/finder?query=remi+agosta&company_domain=piloterr.com
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full name of the person to find the email for |
| `company_domain` | string | no* | Company domain (e.g. `piloterr.com`) |
| `company_name` | string | no* | Company name (e.g. `Piloterr`) |

*At least one of `company_domain` or `company_name` is required.

## Response fields
| Field | Type | Description |
|---|---|---|
| `email` | string | The found email address |
| `status` | string | Validity status: `valid`, `invalid`, or `unknown` |
| `first_name` | string | Parsed first name |
| `last_name` | string | Parsed last name |
| `company_domain` | string | The company domain used for the lookup |

## Notes
- At least one of `company_domain` or `company_name` must be provided.
- `company_domain` produces more accurate results than `company_name` alone.
- The `status` field reflects the deliverability of the found email address.

## Main use cases
- Build outbound sales lists by finding the professional emails of target prospects at specific companies
- Enrich CRM contacts with verified email addresses to improve deliverability and reduce bounce rates
- Automate lead generation workflows by matching names from LinkedIn to their work emails
- Power email marketing campaigns with verified B2B contacts from any company domain