apyhub
DATA VALIDATION · MARKETING

Disposable Email Detector

What it does

Disposable Email Detector checks an email address and returns signals you can use to decide whether it looks temporary or risky. Send an email in the request body, and get back a confidence_score plus a set of detection signals for the domain.

Use the returned signals to inspect whether the domain appears on a blocklist, whether it has disposable_mx characteristics, whether it has has_mx_records, and how old the domain is in domain_age_days. The response also includes an entropy_score for the domain label, which can help flag randomly generated or low-quality domains.

This is useful when you want to reduce fake signups, filter throwaway addresses in lead capture forms, or add an extra risk check before sending account verification or marketing email. Keep your own policy on top of the score: a single signal may not be enough, but the combined confidence_score gives you a compact disposable-email assessment.

If you need a fast validation step in a signup, onboarding, or abuse-prevention flow, Disposable Email Detector gives you structured signals without forcing you to inspect DNS and registration data yourself.

POST
Disposable email detection with confidence score
https://api.eu.apyverse.com/apyhub/detect-disposable-email

QUICKSTART

GUIDE

Quickstart

Check whether an email looks disposable by sending it in a JSON body.

curl -X POST "https://api.eu.apyverse.com/apyhub/detect-disposable-email" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

What you'll get back

Returns a JSON object with a data object. Inside data, signals is an object with disposable-email signals, and confidence_score is a number from 0 to 1 indicating the likelihood the email is disposable.

{
  "data": {
    "signals": {
      "blocklist": false,
      "disposable_mx": false,
      "entropy_score": 0.42,
      "has_mx_records": true,
      "domain_age_days": 1826
    },
    "confidence_score": 0.03
  }
}
TRY ITLIVE · 10 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*

About this endpoint

What it does

Checks whether an email address appears to be disposable and returns a confidence score plus the underlying signals used to compute it.

Request Body

ParameterTypeMandatoryDescription
emailStringYesEmail address to analyze. Must be in email format.

Response

Returns a JSON object with a data object field. data contains signals and confidence_score; signals is an object with several boolean and numeric indicators, and confidence_score is a floating-point disposable-likelihood score from 0 to 1.

ParameterTypeMandatoryDescription
dataObjectNoResponse wrapper containing the detection result.
data.signalsObjectNoSignal object with the individual indicators used to assess disposability.
data.signals.blocklistBooleanNoWhether the domain appears on a blocklist.
data.signals.disposable_mxBooleanNoWhether the domain uses disposable MX infrastructure.
data.signals.entropy_scoreNumberNoShannon entropy of the domain label, as a float from 0 to 1.
data.signals.has_mx_recordsBooleanNoWhether the domain has MX records.
data.signals.domain_age_daysIntegerNoDays since registration via RDAP; -1 when unavailable.
data.confidence_scoreNumberNoAggregated disposable likelihood score, as a float from 0 to 1.

Body

Name
Type
Description
bodyREQUIRED
object
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.