POST AI agent ready /v1/email/validate

Email Validation API - Free Address Verification

Validates an email address with format checking, MX record verification, disposable domain detection, free provider detection, role-based address detection, and typo suggestions.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/email/validate \
  -H "Content-Type: application/json" \
  -d '{"email":"user@gmail.com"}'

When to use this API

Clean signup forms before saving to your database

Call this endpoint on form submit to reject invalid or disposable email addresses before they reach your user table. Catch typos like "gmial.com" with the suggestion field and prompt the user to correct their input.

Score leads in a CRM pipeline

When a new lead enters your CRM, validate their email to check if it is a free provider (Gmail, Yahoo) or a company domain. Prioritize leads with company domains for sales outreach since they are more likely to be business buyers.

Reduce bounce rates before email campaigns

Run your mailing list through this endpoint before sending a campaign. Remove addresses with missing MX records or disposable domains to protect your sender reputation and improve deliverability.

Frequently asked questions

Does this endpoint verify that the mailbox exists?

It verifies MX records exist for the domain, confirms valid format, and detects disposable providers. It does not perform SMTP mailbox verification (connecting to the mail server to check the inbox).

What is a disposable email?

A disposable email is a temporary address from services like Mailinator, Guerrilla Mail, or Tempail. These addresses are often used to bypass signup requirements. The is_disposable flag detects them.

What does the suggestion field return?

When the domain looks like a typo of a popular provider (e.g. "gmial.com" instead of "gmail.com"), the suggestion field returns the corrected email address.

How is a role-based address defined?

Role-based addresses are generic mailboxes like info@, support@, admin@, or sales@. The is_role_based flag is true when the local part matches a known role-based pattern.

Can I validate multiple emails in one request?

This endpoint validates one email per request. For bulk validation, send parallel requests for each address in your list.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.