POST/v1/email/domain-status

Domain Status API

Classify a domain: webmail, disposable, accept-all or gibberish.

Classify any email domain in one call. The Domain Status API flags whether a domain is a free webmail provider, a disposable/throwaway service, an accept-all (catch-all) mail server, or gibberish — the signals you need to score risk before sending or accepting a signup.

Full Docs Get API Key — Free $5 Credit $0.01 / call

Try it live

Fill in the fields and hit Run to see a real response.

POST/v1/email/domain-statusdomain-status$0.01/call

Response

Example response — hit "Send Request" to see a live result

{
  "data": {
    "acceptAll": false,
    "disposable": false,
    "domain": "stripe.com",
    "gibberish": false,
    "webmail": false
  },
  "ok": true
}

Features

✓

Four risk flags in one call

Returns webmail, disposable, acceptAll, and gibberish booleans for the domain, so you classify it completely in a single lightweight request.

✓

Catch-all detection

The acceptAll flag tells you when a server accepts any address, which is why individual SMTP verification on that domain is inconclusive.

✓

Disposable and webmail filtering

Block throwaway domains and flag free webmail providers at signup or before a send to protect your sender reputation.

✓

Lightweight and cheap

A tiny response at $0.01 per call makes it easy to screen every domain in a signup flow or import.

Use cases

Signup Fraud Prevention

Reject disposable and gibberish domains at registration to keep fake accounts out.

List Segmentation

Separate business domains from free webmail to prioritize B2B leads.

Deliverability Screening

Flag accept-all domains where per-address verification can't be trusted.

Quick start

Copy this snippet and start making calls.

const res = await fetch('https://api.yepapi.com/v1/email/domain-status', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "domain": "stripe.com"
  }),
});
const data = await res.json();
console.log(data);

The domain status API — classify any email domain

The Domain Status API classifies an email domain in one call, flagging webmail, disposable, accept-all, and gibberish. Those four signals are what you need to score risk before accepting a signup or sending to a list.

At $0.01 per call with $5 of free credit and no minimums, it's cheap enough to screen every domain in a registration flow. Combine it with the Email Verifier for full address-level deliverability under one key.

Start making API calls in 30 seconds

$5 free credit on signup. No credit card required. Pay per call.

Get API Key — Free $5 Credit

What developers say

“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
Marcus T.
SEO Platform Founder

“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
Priya S.
Full-Stack Developer

“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Jake R.
Indie Hacker

Frequently asked questions

Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.

Sign up for a free API key, then send a POST request to /v1/email/domain-status. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.

YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.