mailboxlayer API

⭐ Beginner's Pick Email / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

mailboxlayer 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. It returns a detailed validation result including a quality score to help you filter out bad sign-ups. A useful tool for keeping your mailing lists clean and reducing bounce rates.

💡

Beginner Tip

The free tier allows 100 requests per month and returns all validation fields, which is enough to prototype an email validation feature. Use the smtp_check field with caution — it performs a live SMTP handshake and may increase latency significantly.

Available Data

email delivery status
message ID
bounce/complaint data
open/click tracking
Use case: Integrate email address validation data into web and mobile applications

Example Response

JSON Response
{
  "message_id": "msg_abc123def456",
  "status": "delivered",
  "to": "[email protected]",
  "subject": "Welcome!",
  "timestamp": "2025-01-15T10:30:00Z"
}

Field Reference

email The email address that was validated
format_valid Whether the email address has a valid syntax format
mx_found Whether a valid MX record exists for the email domain
smtp_check Whether the mailbox exists on the mail server (SMTP handshake result)
disposable Whether the email is from a known disposable or temporary email provider
score Overall quality score from 0 to 1 indicating email deliverability confidence

Implementation Example

const url = "https://mailboxlayer.com/";
// 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

101 Invalid API Key The access_key parameter is missing or incorrect
Double-check your API key from the mailboxlayer dashboard and pass it as access_key=YOUR_API_KEY in the query string
211 User Limit Reached Monthly request quota for the free tier has been exceeded
Upgrade to a paid plan or wait for the quota to reset at the start of next month
HTTPS not supported on free tier Free tier only supports HTTP, not HTTPS
Use http:// for the endpoint on the free plan, or upgrade to a paid plan to enable HTTPS access

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Email
Difficulty Intermediate
Verified: 2026-04-04

Alternatives to mailboxlayer

Technical alternatives for different use cases.

Detects disposable/temporary email addresses

Better For

Blocking signups from disposable email services

Trade-off

Full email deliverability verification

Free email validation with syntax and MX record checks

Better For

Basic email validation without paid plan

Trade-off

Catch-all detection and deliverability scoring

Email sending platform with built-in validation

Better For

Combined email sending and validation in one platform

Trade-off

Standalone email validation without sending needs

Similar APIs

View All →