Email Finder API Documentation | Find B2B Emails Programmatically

Email Finder API

Introduction

The Single Email Finder API enables you to find a professional email address in real time using a person’s name and their company domain. It’s designed for quick, accurate, and reliable results, making it ideal for lead generation, contact enrichment, and outreach.

This endpoint retrieves one email address per request by providing details such as the name and domain. The first result found based on your query will be returned as a response. Each request deducts 10 credits

Authentication

To access the API, you’ll need a valid API key. You can generate your personal key from the API section after logging into your account. This key is required for authentication and to make requests securely.

API Endpoint

Get Request URL (HTTPS)

https://app.emailverify.io/api/v1/finder?key=YOUR_API_KEY&name=John&domain=example.com

Example Response if single email is found

You will receive a response like this if the email is found:

Response if found

{ "email": "jhon@example.com" ,

"status": "found" }

Example Response if email is not found

You will receive a response like this if no email address is found:

Response if not found

{ "email": "null" ,

"status": "not_found" }

Checks Performed in Email Finder

Error Responses

Error Message Description
Invalid API Key The provided API key is disabled or does not exist.
Invalid Request Invalid parameters were provided in the API endpoint.
0 Credits Remaining You do not have enough credits.
Please Try Again An internal error occurred. Try the request again.

Check Account Balance

Use the following GET request to check your current account balance.

Get Request URL (HTTPS):

https://app.emailverify.io/api/v2/check-account-balance?key=<Your_API_Key>

Here, replace the <Your_API_Key> with your active API key.

Response (JSON):

{ "api_status": "enabled" ,

"available_credits": 16750 }

Available credits are the total of your daily available credits, refunded credits, and referral credits. The following endpoint is deprecated and will be removed in future versions.

Get Request URL (HTTPS) [Deprecated]:

https://app.emailverify.io/api/v1/check-account-balance?key=<Your_API_Key>

Here, replace the <Your_API_Key> with your active API key.

Response (JSON):

{ "api_status": "enabled" ,

"daily_credits_limit": 150 ,

"referral_credits": 100 ,

"remaining_credits": 15000 }