apyhub
DATA VALIDATION · MARKETING

Disposable Email Checker API

What it does

Disposable Email Checker lets you detect whether an email address belongs to a known disposable domain. Send an email value and get back the normalized email, the domain, and a boolean disposable flag.

Use it when you need to reduce throwaway signups, filter low-quality leads, or add an extra trust check during account creation. The response is intentionally small and direct, so you can make a yes/no decision without parsing extra metadata.

Because the endpoint works at the domain level, it fits common validation flows where you already have an email address and want to know whether the domain is on a disposable list. If disposable is true, you can block registration, route the user through additional verification, or mark the record for review.

Disposable Email Checker is a good fit for signup forms, onboarding flows, and lead capture pipelines where disposable addresses create noise or abuse.

GET
Detect whether an email address uses a known disposable domain
http://localhost:8080/dosvak/detect-disposable-email
QUICKSTARTGUIDE

Quickstart

Check whether a single email address is disposable by sending it as a query parameter.

curl -X GET "http://localhost:8080/dosvak/[email protected]" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with three top-level fields: email is the email address checked, domain is its domain, and disposable is a boolean indicating whether the email is disposable.

{
  "email": "[email protected]",
  "domain": "example.com",
  "disposable": false
}
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.

About this endpoint

What it does

Checks whether the provided email address belongs to a known disposable domain and returns the email, its domain, and a boolean flag indicating whether it is disposable.

Query Parameter(s)

AttributeTypeMandatoryDescription
emailStringYesThe email address to inspect.

Response

Returns a JSON object with email, domain, and disposable fields. email and domain are strings, and disposable is a boolean indicating whether the domain is disposable.

AttributeTypeMandatoryDescription
emailStringNoThe email address that was checked.
domainStringNoThe domain extracted from the email address.
disposableBooleanNotrue if the domain is disposable, otherwise false.

Query parameters

Name
Type
Description
emailREQUIRED
string
▣ 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.