Can I combine these APIs in one workflow?

Yes. A common pattern runs a cheap disposable or free-provider check first and only escalates borderline addresses to full validation, so an agent spends the least credits needed to reach a decision at signup, lead routing, or list cleaning.

Do these APIs return JSON or XML?

All three endpoints accept a format query parameter that selects JSON or XML output, with JSON as the default and the recommended choice for agent and SDK consumers.

Do the MailboxValidator APIs send email or process addresses in bulk?

No. Each endpoint verifies or classifies one address per call and does not send mail, manage suppression lists, or run bulk validation. They produce the signals your own send or routing logic acts on.

MailboxValidator APIs for AI Agents

Data EnrichmentContact EnrichmentThird-Party SpecsAPI keyAgent Ready

www.mailboxvalidator.com·Developer portal → www.mailboxvalidator.com

MailboxValidator API Catalog

3 APIs across 1 product group. All share one credential.

Data Enrichment3

MailboxValidator Disposable Email CheckerDetect disposable, throwaway, or temporary email addresses on a single GET - block trial abuse and signup spam at the form layer.~1 endpoint MailboxValidator Email ValidationValidate one email address and return the full MailboxValidator signal set - syntax, MX, SMTP, free, disposable, role, and score - in a single GET.~1 endpoint MailboxValidator Free Email CheckerCheck whether a single email address belongs to a free webmail provider - useful for filtering personal addresses out of B2B lead routing.~1 endpoint

Which MailboxValidator API should I use?

I want to...	Use	Why
Filter personal addresses out of B2B lead routing	MailboxValidator Free Email Checker	Returns only the free-webmail verdict, the cheapest signal for separating consumer from corporate addresses.
Block trial abuse and signup spam	MailboxValidator Disposable Email Checker	Flags throwaway inboxes such as 10minutemail and mailinator without spending credits on full validation.
Confirm an address is genuinely deliverable before sending	MailboxValidator Email Validation	Runs syntax, MX, and SMTP checks and returns a numeric score plus free, disposable, and role flags in one call.

Install Jentic One Beta

Connect the MailboxValidator APIs to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the MailboxValidator APIs, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Instead of wiring each MailboxValidator endpoint to the api.mailboxvalidator.com host and threading your key through every request, you install Jentic One once and your agent adds the free-provider, disposable, and validation operations from the Jentic directory. One install covers all three APIs.

Permission scoping

Each MailboxValidator API is a single read-only lookup, so you can scope your agent to just the checks a workflow needs, for example the disposable and free-provider endpoints for signup screening while leaving full validation out. Your own rules decide which operations are in scope.

Credential isolation

Your one MailboxValidator API key is stored encrypted by your own Jentic One instance and injected at execution time across all three APIs. It never enters the agent's prompt, logs, or context.

FAQs

Specific to using MailboxValidator APIs through Jentic.

What can I do across the MailboxValidator APIs?

You can classify a single email address as free-webmail or business, detect disposable throwaway inboxes, and run a full validation that returns syntax, MX, SMTP, free, disposable, and role signals plus a numeric deliverability score. Each API works on one address per call.

Do all three APIs share one API key?

Yes. The free-provider checker, the disposable checker, and the full validation endpoint all use the same MailboxValidator API key, and every call draws on one shared credit-based subscription.

Which API should I use for a given task?

Use the free email checker when you only need to separate consumer addresses from business ones, the disposable checker to block throwaway inboxes at signup, and the full validation endpoint when you need MX, SMTP, and a deliverability score in one call. The single-signal endpoints spend fewer credits than full validation.

How are credits consumed across the endpoints?

MailboxValidator uses a credit model rather than a per-second rate limit, and every call against any of the three endpoints draws credits from the same monthly allowance. Choosing a lightweight single-signal check conserves credits compared with running full validation on every address.

BOOK A DEMO

Start Connecting APIs to Your AI Agents

Browse thousands of APIs and connect them all to your agent with Jentic One. One layer, one credential — every API your agent needs.

Book a Demo

For Agents

APIs3 in catalogue

Endpoints3 indexed

AuthAPI key — 1 credential for all 3 APIs

ProvenanceThird-party specs

An agent can take one email address and, across these APIs, decide whether it is a free-webmail address, a disposable throwaway inbox, or a fully deliverable mailbox with MX and SMTP confirmed and a numeric score. That lets the agent gate signups, qualify B2B leads, and clean mailing lists before a send.

MailboxValidator splits email intelligence into focused single-signal endpoints (free-provider, disposable) plus one full-validation endpoint, so an agent can spend the least credits needed for a given decision instead of paying for a full check every time. All three run off the same key and host, making it simple to move from a cheap boolean check to a complete deliverability verdict.

Use for: Verifying and classifying individual email addresses (free-provider, disposable, syntax, MX, SMTP, role, and deliverability score) one address per call

Not supported: bulk validation, sending email, suppression list management, real-time streaming

Credentials: All three APIs authenticate with the same MailboxValidator API key passed as a query parameter, and that key draws on one shared credit-based subscription.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmailboxvalidator.com" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmailboxvalidator.com" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

What AI Agents Can Do with MailboxValidator

Each workflow spans multiple MailboxValidator APIs. Jentic routes each operation to the right API automatically.

Two-stage signup gate

An agent screens a new signup by first checking whether the address is disposable and whether it is a free-webmail domain, then only escalates borderline cases to a full validation. This spends the fewest credits on obvious rejects while still confirming deliverability for the addresses worth keeping.

Example prompt:

On each new signup, call the disposable check and the free-provider check; reject disposable addresses, tag free-webmail addresses for review, and pass the rest through.

APIs used

MailboxValidator Disposable Email Checker + MailboxValidator Free Email Checker

Lead qualification with deliverability confirmation

An agent qualifies inbound B2B leads by flagging free-webmail addresses to deprioritize consumer signups, then running the full validation to confirm MX, SMTP, and a deliverability score before routing a lead to a sales rep. Corporate, deliverable leads reach an AE while free-mail or undeliverable ones go to a nurture track.

Example prompt:

For each inbound lead, run the free-provider check, then the full validation; route the lead to sales only when it is a business domain with a score of at least 0.7.

APIs used

MailboxValidator Free Email Checker + MailboxValidator Email Validation

Mailing list hygiene pass

An agent cleans an existing subscriber list by removing disposable addresses and validating the remainder for MX and SMTP so bounce-driven reputation damage is reduced before the next campaign. Disposable and undeliverable addresses are suppressed while deliverable ones are retained.

Example prompt:

For each subscriber, call the disposable check, suppress throwaway addresses, then run full validation and suppress any remaining address whose score falls below the send threshold.

APIs used

MailboxValidator Disposable Email Checker + MailboxValidator Email Validation

MailboxValidator APIs for AI Agents

MailboxValidator API Catalog

Data Enrichment3

Which MailboxValidator API should I use?

Connect the MailboxValidator APIs to your agent

Why Jentic?

FAQs

Start Connecting APIs to Your AI Agents

What AI Agents Can Do with MailboxValidator

If you need a different Data Enrichment vendor