Customer API
Email Finder Verifier API docs
Verify an address, or find one from a name and domain. Stable JSON, one API key.
Quickstart
Base URL: https://my.emailfinderverifier.com
Auth
X-API-Key header
Free on signup
100,000 requests
1 credit
1 find or 10 verifies
curl
curl -G "https://my.emailfinderverifier.com/api/v1/verify" \
--data-urlencode "[email protected]" \
-H "X-API-Key: YOUR_API_KEY"Authentication
Every API call requires your key in the X-API-Key header.
- Sign up and your API key is issued automatically, with 100,000 free verification requests. Find it on your dashboard.
- Do not expose keys in browser-side code.
- An account with no requests left, or an invalid key, cannot call the API.
Find email
GET
/api/v1/find
Finds a verified work email from first name, last name, and company domain.
You can also pass their LinkedIn URL. It is optional and the call works the same without it.
Query parameters
| Name | Required | Description |
|---|---|---|
| domain | Yes | Company domain, for example manasai.co. |
| first_name | Yes | Person's first name. |
| last_name | Yes | Person's last name. |
| linkedin_profile | No | LinkedIn profile URL. Stored with the result. |
Request
curl -G "https://my.emailfinderverifier.com/api/v1/find" \
--data-urlencode "domain=manasai.co" \
--data-urlencode "first_name=Reid" \
--data-urlencode "last_name=Hoffman" \
--data-urlencode "linkedin_profile=https://www.linkedin.com/in/reidhoffman/" \
-H "X-API-Key: YOUR_API_KEY"Response
{
"email": "[email protected]",
"esp": "Google"
}Response fields
| Field | Values | Meaning |
|---|---|---|
| string or null | The email we found. We only return addresses we could stand behind, so there is no separate "valid" flag. null means we could not find one. | |
| esp | Google, Outlook, Zoho, Yahoo, Proofpoint, and others | Who runs the mail for that domain. Returned even when no email was found. |
A find costs 10 only when we return an address. Nothing found, nothing charged.
Verify email
GET
/api/v1/verify
Checks whether a single email is real. Use this when you already have an address. Returns whether it is verified, plus who runs the mail for that domain.
Query parameters
| Name | Required | Description |
|---|---|---|
| Yes | Email address to verify. |
Request
curl -G "https://my.emailfinderverifier.com/api/v1/verify" \
--data-urlencode "[email protected]" \
-H "X-API-Key: YOUR_API_KEY"Response
{
"verified": true,
"esp": "Google"
}Response fields
| Field | Values | Meaning |
|---|---|---|
| verified | true / false | true only when we confirmed the mailbox is real. If the domain accepts every address, or we couldn't get a clear answer, this is false. |
| esp | Google, Outlook, Zoho, Yahoo, Proofpoint, and others | Who runs the mail for that domain. Useful for deciding how to send. |
Credits and your balance
- Every account starts with 100,000 verification requests, free. That is also 10,000 emails found.
- A verification request costs 1. A found email costs 10, because finding does ten times the work.
- Every verification request counts, whatever the answer. A find is only charged when we return an address.
- You get a 402 when the balance runs out.
- Short-window safety limits still protect the service from bursts.
Check your balance
Call GET /api/v1/credits any time to see what you have left.
Request
curl "https://my.emailfinderverifier.com/api/v1/credits" \
-H "X-API-Key: YOUR_API_KEY"Response
{
"verify_requests_left": 99989,
"emails_you_can_find": 9998,
"credits_left": 9998,
"unlimited": false,
"hire_a_gtm_engineer": "https://calendly.com/kaushikkulkarni/discovery/"
}Rate limits
Each account can send 1 request per second. Go over and you get a 429. Wait a second and retry.
Error responses
| Status | Meaning | Fix |
|---|---|---|
| 400 | Missing or invalid input. | Check required query parameters. |
| 401 | Missing or invalid API key. | Sign up to get a key (issued automatically) and send it in X-API-Key. |
| 402 | Out of balance. | Your free balance is used up. Contact Up to add more. |
| 403 | Account paused or expired. | Contact Up to reactivate. |
| 429 | Short-window safety limit reached. | Retry after a short delay. |
| 500 | Unexpected server error. | Retry. If it repeats, share the request with Up. |
Error shape
{
"detail": {
"error": "Invalid or missing API key",
"code": "INVALID_API_KEY"
}
}OpenAPI
The customer-safe OpenAPI file is available here:
Spec URL
https://emailfinderverifier.com/docs/openapi.jsonImport this into Swagger, Postman, Insomnia, Stoplight, or any OpenAPI-compatible docs tool.