Skip to content

Latest commit

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

Email Verification API

REST API to verify any email address for deliverability and get owner details like name and gender. Detects disposable emails, free providers, and invalid addresses in real time.

Features

  • Verify email deliverability with syntax, MX record, and SMTP checks
  • Detect disposable/temporary email addresses (Guerrilla Mail, Mailinator, etc.)
  • Identify free email providers (Gmail, Yahoo, Outlook)
  • Get owner details — first name, last name, and gender
  • 200 requests/month on free tier
  • Example Response:
{
"is_valid": true,
"status": "valid",
"is_free_email": false,
"first_name": null,
"last_name": null,
"gender": null
}

Get API Key

Create an account at omkar.cloud to get your API key, and use it in requests. 200 requests are free every month.

Quick Start

curl -X GET "https://email-verification-api.omkar.cloud/verify?email=happy.to.help%40omkar.cloud" \
-H "API-Key: YOUR_API_KEY"
{
"is_valid": true,
"status": "valid",
"is_free_email": false,
"first_name": null,
"last_name": null,
"gender": null
}

Installation

Python

pip install requests
importrequestsresponse=requests.get(
"https://email-verification-api.omkar.cloud/verify",
params={"email": "happy.to.help@omkar.cloud"},
headers={"API-Key": "YOUR_API_KEY"}
)
result=response.json()
print(f"Valid: {result['is_valid']}, Status: {result['status']}")

Node.js

npm install axios
importaxiosfrom"axios";constresponse=awaitaxios.get("https://email-verification-api.omkar.cloud/verify",{params: {email: "happy.to.help@omkar.cloud"},headers: {"API-Key": "YOUR_API_KEY"}});console.log(`Valid: ${response.data.is_valid}, Status: ${response.data.status}`);

API Reference

Endpoint

GET https://email-verification-api.omkar.cloud/verify

Headers

HeaderRequiredDescription
API-KeyYesAPI key from omkar.cloud/api-key

Parameters

ParameterRequiredDescription
emailYesEmail address to verify (e.g., happy.to.help@omkar.cloud)

Response Fields

FieldTypeDescription
is_validbooleanWhether the email address is deliverable
statusstringVerification status ("valid", "invalid")
is_free_emailbooleanWhether the email is from a free provider like Gmail, Yahoo, or Outlook
first_namestring | nullOwner's first name (when available)
last_namestring | nullOwner's last name (when available)
genderstring | nullOwner's gender (when available)

Examples

Verify a business email

response=requests.get(
"https://email-verification-api.omkar.cloud/verify",
params={"email": "info@company.com"},
headers={"API-Key": "YOUR_API_KEY"}
)
result=response.json()
ifresult["is_valid"]:
print("Email is deliverable")
else:
print("Email is invalid — skip sending")

Block disposable emails on signup

response=requests.get(
"https://email-verification-api.omkar.cloud/verify",
params={"email": user_email},
headers={"API-Key": "YOUR_API_KEY"}
)
result=response.json()
ifnotresult["is_valid"]:
print("Blocked: disposable or invalid email")

Enrich CRM contacts with owner details

response=requests.get(
"https://email-verification-api.omkar.cloud/verify",
params={"email": "john@example.com"},
headers={"API-Key": "YOUR_API_KEY"}
)
result=response.json()
ifresult["first_name"]:
print(f"Contact: {result['first_name']}{result['last_name']}")

Error Handling

response=requests.get(
"https://email-verification-api.omkar.cloud/verify",
params={"email": "test@example.com"},
headers={"API-Key": "YOUR_API_KEY"}
)
ifresponse.status_code==200:
data=response.json()
elifresponse.status_code==401:
# Invalid API keypasselifresponse.status_code==429:
# Rate limit exceededpass

Rate Limits

Our TierOur PriceOur Requests
Free$0200
Starter$168,000
Grow$4824,000
Scale$14874,000

Questions? We have answers.

Reach out anytime. We will solve your query within 1 working day.

Contact Us on WhatsApp about Email Verification API

Contact Us on Email about Email Verification API