Overview
MailboxValidator performs multi-layered email address validation including syntax checking, DNS/MX record lookup, disposable email detection, and SMTP mailbox verification to help improve email list deliverability. It provides detailed per-signal results so you can tune acceptance thresholds to your use case. An API key from mailboxvalidator.com is required; a free tier with 100 verifications per month is available.
Beginner Tip
MailboxValidator returns several individual checks rather than a single pass/fail, giving you full control over how strict your validation is. The free API key is available without a credit card — ideal for testing email form validation on small projects.
Available Data
The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.
Example Response
Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.
{
"message_id": "msg_abc123def456",
"status": "delivered",
"to": "[email protected]",
"subject": "Welcome!",
"timestamp": "2025-01-15T10:30:00Z"
} Field Reference
email_address The email address that was submitted for validation status Overall validation result: ok (mailbox exists), fail (does not exist), or unknown (could not verify) is_syntax True/False string indicating whether the email passes RFC syntax rules is_mx True/False string indicating whether the email domain has valid MX records for receiving mail is_disposable True/False string flagging whether the domain is a known temporary or disposable email provider is_free True/False string indicating whether the email uses a free consumer mail provider like Gmail or Yahoo Implementation Example
Calls a real endpoint of this API. Replace any placeholder credentials with your own key.
const url = "https://api.mailboxvalidator.com/v2/validation/single?email=example%40gmail.com&api_key=YOUR_API_KEY";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
headers: {
"X-API-Key": "YOUR_API_KEY"
}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.
Metadata Score Breakdown
Estimated from metadata — endpoint not independently tested
Metadata estimate · endpoint not independently tested
Technical Specifications
Related Tags
Similar APIs
View All →Cloudmersive Validate
⭐ Beginner's PickCloudmersive Validate is a comprehensive validation API that can verify email addresses, phone numbers, VAT numbers, and domain names in a single platform.
Email Validation
Abstract API Email Validation checks whether an email address is deliverable, properly formatted, and not from a disposable or spam-trap domain.
ImprovMX
ImprovMX is an email forwarding service with a REST API that lets you programmatically manage domains and forwarding rules — mapping email aliases to real destination addresses.
mailboxlayer
⭐ Beginner's Pickmailboxlayer is an email validation API that checks whether an email address is syntactically correct, has a valid MX record, and is not a disposable address.
mail.gw
mail.gw is a REST API for creating and managing temporary 10-minute email addresses with full inbox access, all without authentication for basic use.