Email Verification API & SDKs
Validate email addresses in real-time or clean millions of records with our fast, reliable, and affordable email verification service.
What does an email verification API do?
An email verification API tells your app whether an address can receive mail. Your backend sends the address over HTTPS. The API returns one status and the reason behind it. Your code then accepts, flags or rejects the address.
Run it at sign-up to stop fake accounts. Run it at checkout to catch typos. Run it on a list before a campaign to protect your sender reputation, because email lists decay by about 22.5% a year. The BillionVerify email verification API handles one address or a full file.
Step 1
Syntax
Rejects malformed input and common typos before any network call.
Step 2
Domain
Confirms that the domain exists and is set up to use email.
Step 3
MX records
Finds the mail servers that receive mail for the domain.
Step 4
SMTP
Asks the receiving server about the mailbox and stops before any message is sent.
What does each email status mean?
Each result carries a single status, so your code stays simple. Read the status reference and the verification reasons for the full list.
| Status | Meaning | Cost |
|---|---|---|
| valid | The mailbox accepts mail. | 1 credit |
| invalid | The address cannot receive mail. | 1 credit |
| catchall | The domain accepts every address, so one mailbox cannot be confirmed. | 1 credit |
| role | A shared inbox such as info@ or support@. | 1 credit |
| disposable | A temporary inbox from a known provider. | Free unless check_smtp is true |
| unknown | The mail server gave no definite answer. | Free |
{
"code": "0",
"message": "Success",
"data": {
"email": "user@example.com",
"status": "valid",
"is_deliverable": true,
"is_disposable": false,
"is_catchall": false,
"is_role": false,
"reason": "accepted",
"credits_used": 1
}
}
How do you verify an email in code?
Install a package and verify your first address in a few lines. SDKs cover Node.js, TypeScript, Python, Go, PHP and Java. They are open-source reference implementations on GitHub. The REST API is the source of truth.
// npm install billionverify-sdk
import { BillionVerify } from 'billionverify-sdk';
const client = new BillionVerify({
apiKey: process.env.BV_API_KEY,
});
const result = await client.verify('user@example.com');
console.log(result.status);
# pip install billionverify
from billionverify import BillionVerify
client = BillionVerify(api_key="your-api-key")
result = client.verify("user@example.com")
print(result.status)
print(result.is_deliverable)
// go get github.com/BillionVerify/billionverify-go
client, err := billionverify.NewClient(billionverify.Config{
APIKey: "your-api-key",
})
if err != nil {
log.Fatal(err)
}
result, err := client.Verify(context.Background(), "user@example.com", nil)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Status: %s\n", result.Status)
Should you use real-time or bulk verification?
Use real-time verification inside a form and bulk verification for lists you already have. Most teams use both.
How do you block temporary email at sign-up?
Temporary inboxes disappear within minutes or days. Your receipts and reset links go nowhere. The API flags these addresses, so your form can refuse them or tag them as low trust.
Check one address with the free disposable email checker. For code, use the open-source library with Go and Rust packages, or the free disposable check endpoint. Our guide to blocking temporary email covers the signals.
if disposable.IsEmail("user@mailinator.com") {
// refuse, throttle, or tag as low-trust
}Connect email verification to your stack
You do not have to write code to use the API. Connect an AI agent, a CRM or a form builder, and addresses get checked where you already work.
How much does email verification cost?
Pay-as-you-go starts at $0.001 per email, and annual plans go down to $0.00014 per email. In our October 2026 benchmark, 10,000 verifications cost $10 with BillionVerify and $129 with ZeroBounce at list price. See BillionVerify pricing, or compare 19 providers in the 2026 benchmark.
Catch-all, separately
Catch-all gets its own status. It is never counted as valid.
Unknown costs nothing
No definite answer means no charge.
24-hour re-check
Checking the same address again within 24 hours is not charged twice.
Credits never expire
Paid and free credits stay until you use them.
Latest guides
All guidesEmail verification API FAQs
What is an email verification API?
An email verification API is a web service that tells your app whether an address can receive mail. You send one address or a list. The API returns a status for each address, and your code decides what to do next.
Does email verification send an email?
Email verification does not send a message. The check asks the receiving mail server about the mailbox and stops before any message is sent.
What does an unknown result mean?
An unknown result means the mail server gave no definite answer. Unknown results cost nothing, and a re-check within 24 hours is free.
Is a catch-all address counted as valid?
Catch-all is reported as its own status. A catch-all domain accepts every address, so nobody can confirm one mailbox on it.
Which languages have an SDK?
SDKs cover Node.js, TypeScript, Python, Go, PHP and Java. They are open-source reference implementations on GitHub. The REST API is the source of truth, and any language can call it over HTTPS.
Can the API block temporary email at sign-up?
The API flags disposable addresses in its result, so your form can refuse them or tag them as low trust. A separate disposable check endpoint is free and does not use credits.
Is there a free tier?
Every account gets 20 free credits on each day you use it, up to 600 a month. Free credits never expire, and you need no credit card.
Start with 20 free credits a day
Up to 600 a month. They never expire. No credit card required.
Get Started FreeBy BillionVerify Team · Updated