apyhub
COMMUNICATIONS · DEVELOPER TOOLS

Email Syntax Validator API

What it does

Email Syntax Validator checks whether an email address is valid at the syntax level. Send an email string and get back a response with the original email, the parsed local part, the domain, and a boolean valid flag.

Use it when you need fast client-side or server-side format checks before you store an address, queue a signup flow, or pass data to a downstream messaging system. Because this endpoint validates syntax only, it does not perform DNS or mailbox verification, so it stays instant and predictable for high-volume validation steps.

The response is simple to consume: if valid is true, the address matches email formatting rules; if it is false, you can reject it or prompt the user to correct the input. The local and domain fields are useful when you want to inspect or log the parts of the address separately.

GET
Validate email address syntax (no DNS, instant)
http://localhost:8080/dosvak/validate-email-syntax
QUICKSTARTGUIDE

Quickstart

Check whether an email address is syntactically valid 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 these top-level fields: email (string), local (string), valid (boolean), and domain (string).

{
  "email": "[email protected]",
  "local": "jane.doe",
  "valid": true,
  "domain": "example.com"
}
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

Validates the syntax of an email address without performing any DNS lookup. It returns a JSON object describing the parsed email parts and whether the address is syntactically valid.

Query Parameter(s)

AttributeTypeMandatoryDescription
emailStringYesThe email address to validate.

Response

Returns a JSON object with email, local, valid, and domain fields. email, local, and domain are strings, and valid is a boolean indicating whether the syntax check passed.

ParameterTypeMandatoryDescription
emailStringNoThe email address as returned by the service.
localStringNoThe local part of the email address.
validBooleanNoWhether the email address is syntactically valid.
domainStringNoThe domain part of the email address.

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.