apyhub
COMMUNICATIONS · DATA VALIDATION

Email Validation Report

What it does

Email Validation Report checks an email address and returns a validation result you can use to score leads, reduce bounce rates, or gate account creation. Send an email, get back a structured report with score, valid, syntax, reachable, disposable, mx_records, role_based, suggestion, and free_provider.

Use it when you need to decide whether an address looks deliverable before you send a verification message, add it to a CRM, or accept a signup. The valid flag is true only when syntax, MX, disposable status, and reachability meet the service’s rules. The score gives you a simple 0–100 signal for downstream automation, while suggestion can point out common domain typos like a misspelled mailbox provider.

Because the response includes both technical checks and a reachability signal, you can separate obvious bad input from addresses that are syntactically correct but risky. That makes Email Validation Report useful for form validation, email list hygiene, and onboarding flows where you want to keep bad addresses out without over-filtering legitimate users.

POST
Advanced email validation report
https://api.eu.apyverse.com/apyhub/advanced-email-validation-report

QUICKSTART

GUIDE

Quickstart

Check an email address and get its validation report.

curl -X POST "https://api.eu.apyverse.com/apyhub/advanced-email-validation-report" \
  -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 containing validation details. The data object may include score (0–100), valid (boolean), syntax (boolean), reachable (yes, no, unknown, or risky), disposable (boolean), mx_records (boolean), role_based (boolean), suggestion (a typo hint string when available), and free_provider (boolean).

{
  "data": {
    "score": 98,
    "valid": true,
    "syntax": true,
    "reachable": "yes",
    "disposable": false,
    "mx_records": true,
    "role_based": false,
    "suggestion": "gmail.com",
    "free_provider": true
  }
}
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

Validates an email address and returns a JSON object with a data object containing validation signals and a score. The request sends an email in the body; the response reports syntax, deliverability-related checks, and an overall score.

Request Body

ParameterTypeMandatoryDescription
emailStringYesThe email address to validate. Must be a valid email format.

Response

Returns a JSON object with a data object. Inside data, score is an integer from 0 to 100, valid is a boolean, syntax is a boolean, reachable is an enum string, disposable is a boolean, mx_records is a boolean, role_based is a boolean, suggestion is a string, and free_provider is a boolean. Success responses are represented by this object shape.

ParameterTypeMandatoryDescription
dataObjectNoValidation result object.
data.scoreIntegerNoScore from 0 to 100.
data.validBooleanNoTrue when syntax, MX, not disposable, and reachable is not "no".
data.syntaxBooleanNoIndicates whether the email syntax is valid.
data.reachableENUMNoEmail reachability status. Allowed values: yes, no, unknown, risky.
data.disposableBooleanNoIndicates whether the email is disposable.
data.mx_recordsBooleanNoIndicates whether MX records were found.
data.role_basedBooleanNoIndicates whether the email is role-based.
data.suggestionStringNoDomain typo hint, such as a corrected domain suggestion. Omitted when empty.
data.free_providerBooleanNoIndicates whether the email uses a free provider.

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.