apyhub
COMMUNICATIONS · DATA VALIDATION

Advanced Email Verification API

What it does

Email Verification checks whether an email address is valid and returns a simple result envelope with a numeric code and a success flag. Send an email in the query string and use the response to gate signups, clean contact lists, or reduce bad addresses before you send mail.

Use Email Verification when you need a lightweight validation step in a registration flow, lead form, CRM import, or bulk list cleanup job. It fits into systems that want a fast pass/fail check without pulling in a larger identity or enrichment workflow.

The request schema is minimal: one email field. The response schema guarantees a standard wrapper, and the service may include additional module blocks alongside code and success. That makes it easy to check the outcome while still leaving room for extra response details when they are available.

If you already validate email format at the edge, Email Verification gives you a second check before you store, message, or synchronise the address downstream.

GET
Email Verification
https://api.eu.apyhub.com/quadlem/email-verification

QUICKSTART

GUIDE

Quickstart

Use the following request to validate an email address and retrieve deliverability, domain, and fraud risk information.

curl -X GET "https://api.eu.apyhub.com/quadlem/[email protected]" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

A successful request returns details about the email address, including its validity, deliverability, domain information, mail server status, and an overall risk assessment.

{
  "success": true,
  "code": 200,
  "EMAIL": {
    "email": "[email protected]",
    "domain": "example.com",
    "valid": true,
    "is_deliverable": true,
    "is_disposable": false,
    "is_role": false,
    "mx": {
      "found": true,
      "provider": "Google",
      "reputable": true
    },
    "risk_score": 0,
    "risk_level": "low",
    "recommendation": "accept",
    "summary": "This looks like a valid, deliverable email address with no risk indicators (0/100 — low risk). Recommended action: accept."
  }
}

Note: Depending on the email address and service configuration, the response may include additional validation and reputation signals to help assess email quality and fraud risk.

TRY ITLIVE · 40 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

Verifies an email address's syntax and deliverability, and flags disposable, role-based, free-provider, and catch-all addresses. Also checks MX records, domain age, and Gravatar presence, returning a fraud risk score and recommendation.

Query Parameter(s)

AttributeTypeMandatoryDescription
emailStringYesEmail address to verify. Must be a valid email format.

Response

AttributeTypeDescription
successBooleanWhether the request succeeded.
codeIntegerNumeric response code.
EMAILObjectEmail verification result.
EMAIL.email / normalizedStringThe address as submitted and normalized.
EMAIL.user / domainStringLocal part and domain of the address.
EMAIL.validBooleanOverall validity (syntax + deliverability).
EMAIL.is_valid_syntaxBooleanWhether the address is syntactically valid.
EMAIL.is_deliverable / deliverabilityBoolean/StringWhether mail can be delivered, and the deliverability status.
EMAIL.is_disposableBooleanWhether it's from a disposable/temporary email provider.
EMAIL.is_roleBooleanWhether it's a role address (e.g. info@, support@).
EMAIL.is_free_providerBooleanWhether it's from a free consumer email provider.
EMAIL.is_catch_all / catch_allBoolean/ObjectWhether the domain accepts all addresses (catch-all).
EMAIL.mxObjectMX record lookup — found, provider, reputability, records.
EMAIL.gravatarObjectWhether a Gravatar profile exists for this address.
EMAIL.domain_ageObjectDomain registration age and date.
EMAIL.breachesObjectKnown data-breach exposure, where checked.
EMAIL.reputationObjectExternal reputation signal, where checked.
EMAIL.risk_scoreNumberOverall fraud risk score.
EMAIL.risk_levelStringlow, medium, or high.
EMAIL.recommendationStringaccept, review, or reject.
EMAIL.summaryStringPlain-language explanation of the result.
EMAIL.reasonsArrayCodes/messages explaining the risk drivers.

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.