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 the mail server would not give a straight 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.
- Paid plans lift the cap and raise your rate. See the plans.
- Free and pilot accounts get a 402 when the balance runs out. Paid plans have no balance to run 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
Plans differ by how many requests per second you can send. Volume is not capped.
| Plan | Requests / second | Max per month |
|---|---|---|
| Free / Pilot | 1 | limited by your balance |
| Starter | 1 | 2.6M |
| Growth | 5 | 13M |
| Scale | 10 | 25.9M |
Go over and you get a 429. Wait a second and retry. Monthly figures are the theoretical maximum at full rate.
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. See the plans. |
| 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.