Mailboxlayer

Operational

Email Validation & Verification JSON API · by APILayer

Get your API key

Free plan · 100 requests / month · no card

Overview

API info

Mailboxlayer is a simple and powerful REST API that offers instant email address validation and verification. It helps developers fight fraudulent users and increase delivery rates by checking syntax, typos, and SMTP records in real-time using a lightweight JSON format.

Example request

GETShellcurl
curl --request GET \
  --url "https://api.apilayer.net/mailboxlayer/api/check?access_key=YOUR_ACCESS_KEY&[email protected]"
Run it in the Playground

Example response

200 - OK
{
    "email": "[email protected]",
    "did_you_mean": "",
    "user": "support",
    "domain": "apilayer.com",
    "format_valid": true,
    "mx_found": true,
    "smtp_check": true,
    "catch_all": false,
    "role": true,
    "disposable": false,
    "free": false,
    "score": 0.8
}

Features

  • Real-time verification

    Verify the actual existence of an email address using instant MX-record and Simple Mail Transfer Protocol (SMTP) checks. This ensures you only send emails to mailboxes that are active and able to receive messages.

  • Syntax & typo check

    Automatically check email syntax and detect potential typos in the domain name. The API provides “did-you-mean” suggestions (e.g., suggesting “gmail.com” if a user types “gmai.com”) to improve user experience and data quality.

  • Disposable & free provider detection

    Filter out disposable email addresses (e.g., Mailinator) and identify free email providers (e.g., Gmail, Yahoo) instantly. This helps you prevent fraudulent sign-ups and segment your user base effectively.

  • Quality & deliverability score

    Receive a numeric quality score between 0.01 and 1 for every verified email address. This score reflects the quality and deliverability of the email, allowing you to automatically filter “real” users from potential abusers.

Pricing

Flexible plan for every stage of growth

Start free. Upgrade when you go live.

MonthlyYearlySave up to 15%

Free

For testing and side projects

$0forever

No credit card

No overage charges

Get free API key

100 requests / month

Includes:

  • Email Validation
  • Syntax & Typo Check
  • Free/Disposable Provider DB
  • Quality Score
See all 10 features

Starter

For your first live product

$14.99/ month

Billed monthly

Then $0.011992 per extra request, up to 10,000 extra a month

Subscribe now

5,000 requests / month

Everything in Free, plus:

  • Real-time SMTP Check
  • MX-Records Check
  • 256-bit HTTPS Encryption
  • Catch-all Detection

+ 1 more

See all 10 features
Most popular

Professional

For growing traffic

$74.99/ month

Billed monthly

Then $0.0059992 per extra request, up to 100,000 extra a month

Subscribe now

50,000 requests / month

Everything in Starter, plus:

  • 10× the requests of Starter
  • Lower cost per request
  • Bulk Endpoint: 25 emails
See all 10 features

Enterprise

For high volume

$249.99/ month

Billed monthly

Then $0.00399984 per extra request, up to 500,000 extra a month

Subscribe now

250,000 requests / month

Everything in Professional, plus:

  • 5× the requests of Professional
  • Lower cost per request
  • Bulk Endpoint: 100 emails
See all 10 features

Custom

Need more? Contact sales for custom needs.

Contact us

Compare all features

10 featuresFree$0Get free keyStarter$14.99/moSubscribeProfessional$74.99/moSubscribeEnterprise$249.99/moSubscribe
Email Validation
Syntax & Typo Check
Free/Disposable Provider DB
Quality Score
Real-time SMTP Check–
MX-Records Check–
256-bit HTTPS Encryption–
Catch-all Detection–
Bulk Endpoint––25 emails100 emails
Standard Support–
Price per extra request after the monthly limitNone$0.011992$0.0059992$0.00399984

Playground

Try the API

Build a request in your browser and see the response it returns.

GET
smtp Optional
catch_all Optional

Add your free API key to run it from your code.

curl
200 - OK

      
    

Agents

Agents: start here

Steps for AI coding agents that add Mailboxlayer to a project.

  1. 1Get an API key

    A person creates the account: an agent cannot sign up. Sign up at app.apilayer.com and subscribe to Mailboxlayer. The Free plan includes 100 requests / month and needs no credit card.

    Copy the API key from the APILayer dashboard and give it to the agent as an environment variable (step 2).

  2. 2Keep the key out of code

    Read the key from an environment variable named APILAYER_ACCESS_KEY. Do not write the key into source code, commit it to git, or paste it into a chat.

    Call Mailboxlayer from server code. The key travels in the request URL, so a request sent from a browser shows the key to every visitor.

    .env
    # add .env to .gitignore
    APILAYER_ACCESS_KEY=your_api_key
  3. 3Make the first request

    Base URL
    https://api.apilayer.net/mailboxlayer/api
    Auth
    access_key query parameter
    Formats
    JSON
    Endpoints
    • /check Check email
    Shell
    curl "https://api.apilayer.net/mailboxlayer/api/check?access_key=$APILAYER_ACCESS_KEY&[email protected]"

    The API info tab shows the response this request returns.

  4. 4Check the plan before you use a feature

    Each plan adds features to the plan before it. Check that the account's plan includes a feature before writing code that uses it.

    PlanRequests / monthAdds
    Free100Email Validation, Syntax & Typo Check, Free/Disposable Provider DB, Quality Score
    Starter5,000Real-time SMTP Check, MX-Records Check, 256-bit HTTPS Encryption, Catch-all Detection, Standard Support
    Professional50,000Bulk Endpoint: 25 emails
    Enterprise250,000Bulk Endpoint: 100 emails

    Prices are in the Pricing tab.

  5. 5Use the machine-readable docs

FAQs

Need clarity?

Here are the answers you might be seeking

Data & features

01.What is Mailboxlayer?

Mailboxlayer is a JSON-based REST API that validates and verifies email addresses in real-time. It checks syntax, verifies the existence of the email via SMTP, and filters out disposable or free providers to improve delivery rates.

02.How does the email validation work?

The API performs a multi-stage check: it first validates the email syntax, then checks for valid MX records and SMTP server responses, and finally cross-references the domain against a database of known disposable and free email providers.

03.What information does the API return?

The API returns a detailed JSON object containing the email’s validity status, a quality score (0 to 1), a “did you mean” suggestion for typos, and flags for disposable, role-based, or catch-all addresses.

04.Can Mailboxlayer detect "catch-all" addresses?

Yes, the API can identify if an email domain is configured as a “catch-all” server (one that accepts all emails sent to it, regardless of the recipient). This helps you segment your lists and avoid low-quality leads.

05.What is mailboxlayer?

Mailboxlayer is a free, simple and powerful JSON API offering instant email address validation & verification via syntax checks, typo and spelling checks, SMTP checks, free and disposable provider filtering, and much more. Its system is REST-based, secured by 256-bit HTTPS encryption, and pursuing the goal of assisting developers and businesses in fighting fraudulent users, increasing success rates of email campaigns and only sending email to real customers.

At mailboxlayer we believe that every online business should be verifying email addresses before letting them into their database, that is why we decided to offer 100 monthly validation requests for free.

06.How accurate is the SMTP Check?

In most cases the mailboxlayer API's SMTP check is entirely accurate when it comes to detecting whether or not an email address actually exists. We are saying "most" cases because certain mail servers tend to suddenly behave in unexpected ways and cause trouble out of nowhere, which may decrease the effectiveness of "pinging" a mail server via SMTP at times.

Combined with all other mailboxlayer validation tools, however, there is no better way to separate low-quality addresses from high-value email contacts and to successfully keep fraudulent users out of your system.

07.What's wrong with disposable email addresses like "mailinator.com"?

Email addresses like "mailinator.com" or "trashmail.com" are using disposable email provdiders, which offer an anonymous way to create a one-time email address. These inboxes are often publicly visible and associated with fraudulent behaviour. We highly advise against approving these types of email addresses in your system or list of recipients.

API access

01.What is an API request?

Pricing is based on the number of monthly API Requests offered for each individual Subscription Plan. Accessing any type of mailboxlayer API data using a valid API Access Key counts as one "API Request".

02.What is the API's uptime?

The mailboxlayer API's system status is being closely monitored around the clock. Since every effort is made to ensure the highest possible level of consistency, we are happy to announce that our API's uptime is at around 99.9%.

Plans & pricing

01.Is there a free plan available?

Yes, Mailboxlayer offers a free subscription plan that includes 100 API requests per month. It provides access to all standard validation tools, making it perfect for testing and small-scale applications.

02.How does pricing scale as my usage grows?

Paid plans start at $9.99/mo for 10,000 requests and scale up to the Enterprise plan with 500,000 monthly requests. Higher-tier plans unlock real-time updates, extended historical data (up to 30+ years), and commercial use rights. You can view pricing features here.

03.Why wouldn't I send email to free email addresses like "Gmail"?

Generally, sending email to free email addresses like "Gmail" or "Yahoo!" is perfectly okay. For certain types of email campaigns, however, it might make sense to sort out users utilizing free email providers in order to reduce bounce rates.

04.Can I also pay yearly?

Yes. If you choose annual billing, the total price of your subscription plan will be up to 15% lower than the total amount you would pay with a monthly payment frequency.

05.What if I consistently have more API calls than my plan allows?

If your usage consistently surpasses the set limits each month, you may face additional charges for the excess usage. Nevertheless, as your monthly usage reaches a certain threshold, it becomes more practical to consider upgrading to the next plan. By doing so, you ensure a smoother and more accommodating experience for your growing customer base.

Overages

01.What happens if I exceed my API Request volume?

Users will be automatically notified via e-mail and on their Account Dashboard once at least 75%, 90%, and 100% of their monthly API Request allowance has been reached. After reaching 100% of the allowance, overages fees will apply so we make sure you won’t experience any disruptions and your website/application will keep running smoothly.

02.What is an overage?

An overage occurs when you go over a quota for your API plan. When you reach your API calls limit, we will charge you a small amount for each new API call so we can make sure there will be no disruption in the service we provide to you and your website or application can continue running smoothly.

Prices for additional API calls will vary based on your plan.

03.Why does APILayer have overage fees?

Overage fees allow customers to continue using an API once a quota limit is reached. We want to make sure your website or application continues running at all times, so charges will apply if you go over your monthly quota limit. If you notice you are going over your quota limit each month, look on your dashboard for an upgraded plan to help with larger request limits.

04.How do I know if I will be charged for overages?

When you are close to reaching your API calls limit for the month, you will receive an automatic notification (at 75%, 90%, and 100% of your monthly quota). You can keep track of your quota usage to prevent overages by tracking the number of API calls you make and checking the dashboard for up-to-date usage statistics.

Still have a question?

Contact support

Mailboxlayer reviews

4.3

11 reviews on G2

Source: G2.com, Inc.

See all on G2

Mailboxlayer has 11 reviews on G2.

View more on G2