apyhub
COMMUNICATIONS · DATA VALIDATION

Email Deliverability Score API

What it does

Email Deliverability Score checks an email address for three common deliverability signals: syntax validity, MX availability, and whether the domain is disposable. Send an email string and get back a compact result you can use to decide whether an address is worth storing, sending to, or asking the user to correct.

The response includes the original email, a numeric score from 0 to 3, the corresponding level (low, medium, or high), and max for the scale ceiling. It also returns boolean flags for valid_syntax, has_mx, and disposable, so you can inspect the specific reasons behind the score instead of relying on a single label.

Use Email Deliverability Score in signup forms, lead capture flows, CRM hygiene jobs, and onboarding pipelines where early email checks reduce bounce risk and bad data. The output is small and direct, which makes it easy to gate account creation, flag suspicious addresses for review, or route questionable emails into a confirmation step.

If you only need a fast, structured check of an address before sending mail or creating a user record, this endpoint gives you the key signals without extra parsing.

GET
Combined deliverability score from syntax, MX, and disposable checks
http://localhost:8080/dosvak/email-deliverability-score
QUICKSTARTGUIDE

Quickstart

Check an email address’s deliverability score by passing the email 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 these top-level fields: max (integer), email (string), level (string: low, medium, or high), score (integer from 0 to 3), has_mx (boolean), disposable (boolean), and valid_syntax (boolean).

{
  "max": 3,
  "email": "[email protected]",
  "level": "high",
  "score": 3,
  "has_mx": true,
  "disposable": false,
  "valid_syntax": 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.

About this endpoint

What it does

Checks a single email address and returns a combined deliverability score based on syntax, MX, and disposable-email checks.

Query Parameter(s)

AttributeTypeMandatoryDescription
emailStringYesThe email address to evaluate.

Response

Returns a JSON object with the top-level fields max (integer), email (string), level (string enum), score (integer), has_mx (boolean), disposable (boolean), and valid_syntax (boolean). The level field can be low, medium, or high, and score is constrained to values from 0 to 3.

AttributeTypeMandatoryDescription
maxIntegerNoMaximum possible score.
emailStringNoThe email address that was evaluated.
levelENUMNoDeliverability level. Allowed values: low, medium, high.
scoreIntegerNoDeliverability score, from 0 to 3.
has_mxBooleanNoIndicates whether the domain has MX records.
disposableBooleanNoIndicates whether the email is from a disposable provider.
valid_syntaxBooleanNoIndicates whether the email syntax is valid.

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.