> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emailfinderverifier.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Sign up, get your key and make your first request.

**1. Sign up**

Create an account at [my.emailfinderverifier.com/sign-up](https://my.emailfinderverifier.com/sign-up). You can sign up with Google or with your work email.

**2. Copy your API key**

Your key is shown on the Get started page right after you sign up, and you can create more under **API keys** in the dashboard. Keep it secret: anyone with the key can spend your balance.

**3. Make your first request**

Verify an address. Replace `YOUR_API_KEY` with your key.

```bash cURL theme={null}
curl "https://api.emailfinderverifier.com/api/v1/verify?email=jane@acme.com" \
  -H "X-API-Key: YOUR_API_KEY"
```

```python Python theme={null}
import requests

r = requests.get(
    "https://api.emailfinderverifier.com/api/v1/verify",
    params={"email": "jane@acme.com"},
    headers={"X-API-Key": "YOUR_API_KEY"},
    timeout=120,
)
r.raise_for_status()
print(r.json())  # {"verified": true, "esp": "Outlook"}
```

```javascript Node theme={null}
const url = new URL("https://api.emailfinderverifier.com/api/v1/verify");
url.searchParams.set("email", "jane@acme.com");

const res = await fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
console.log(await res.json()); // { verified: true, esp: "Outlook" }
```

**4. Find an email**

Pass a first name, last name and company domain. You get the address back only when it's verified; otherwise `email` is `null`.

```bash cURL theme={null}
curl -G "https://api.emailfinderverifier.com/api/v1/find" \
  --data-urlencode "domain=acme.com" \
  --data-urlencode "first_name=Jane" \
  --data-urlencode "last_name=Doe" \
  -H "X-API-Key: YOUR_API_KEY"
```

```python Python theme={null}
import requests

r = requests.get(
    "https://api.emailfinderverifier.com/api/v1/find",
    params={"domain": "acme.com", "first_name": "Jane", "last_name": "Doe"},
    headers={"X-API-Key": "YOUR_API_KEY"},
    timeout=120,
)
print(r.json())  # {"email": "jane.doe@acme.com", "esp": "Google"}
```

```javascript Node theme={null}
const url = new URL("https://api.emailfinderverifier.com/api/v1/find");
url.search = new URLSearchParams({ domain: "acme.com", first_name: "Jane", last_name: "Doe" });

const res = await fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" } });
console.log(await res.json()); // { email: "jane.doe@acme.com", esp: "Google" }
```

> [!TIP]
>
> Some checks take a while to come back. Set your HTTP timeout to at least 60 seconds, and 120 seconds for generic inboxes.

## Next steps

* `verified: false` doesn't always mean the address is bad. Read [Verify an email](https://docs.emailfinderverifier.com/api-reference/verify/verify-an-email.md) before you drop any `false` results.
* Check your balance any time with [`GET /api/v1/credits`](https://docs.emailfinderverifier.com/api-reference/account/check-your-balance).
* See every endpoint in the [API reference](https://docs.emailfinderverifier.com/api-reference/verify/verify-an-email.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.