Email Finder

Email Finder

The Email Finder API attempts to find a person's email address based on the provided input parameters, ensuring accurate and reliable results.

Endpoint

POST /api/v1/email_finder

Base URL

https://smtpghost.com/api/v1/email_finder

Headers

Header	Value	Required
Content-Type	application/json	Yes
X-KEY	<your-organization-api-key>	Yes

Request Body

{
  "full_name": "Kevin Urrutia",
  "domain": "voymedia.com"
}

Success Response (200 OK)

Email Found

{
  "status": "success",
  "full_name": "Kevin Doe",
  "domain": "voymedia.com",
  "email_address": "[e-mail]",
  "email_status": "VALID",
  "account_type": "professional",
  "is_catch_all": false
}

No Email Found

{
  "status": "not_found",
  "full_name": "Kevn Urrutia",
  "domain": "voymedia.com",
  "message": "No valid or risky email found for the given name and domain."
}

Note: The endpoint returns status: "success" only when an email is found; otherwise it returns status: "not_found"—never an HTTP error—for “no-email” cases.

Error Responses

400 Bad Request

{
  "error": "Please provide both full name and domain."
}

402 Payment Required

{
  "error": "Insufficient credits. You need 1 credit to perform email finder."
}

422 Unprocessable Entity

{
  "error": "Unable to split full name into first and last name."
}

500 Internal Server Error

{
  "status": "error",
  "error": "An internal error occurred: <details>"
}

On any unexpected exception, credits are refunded and a 500 is returned with status: "error".