get

Detect email characteristics

Analyzes an email for syntax, normalization, typo suggestions, role/public/relay/disposable signals, evidence, DNS classification flags, and optional team policy overlay. Invalid TLDs can return suggested_email and suggested_domain while syntax_validation remains false.

/api/v1/emails/detect

Code samples

curl --request GET \
  --url 'https://api.emailguard.co/api/v1/emails/detect?email=user%40example.com' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Parameters

Query parameters

Name	Type	Description
emailrequired	string	Email address to analyze

Responses

200

codestringrequired

Machine-readable status code (for example SUCCESS or INVALID_BODY).

confidencestring

high, medium, or low. Always set on a successful detect response.

detection_sourcestring

disposableboolean

disposable_providerstring

domainstring

emailstring

infra_cluster_matchboolean

True when the domain shares MX/A infrastructure with a known disposable cluster.

matched_rulesunknown[]

Matched catalog/staff rules without exposing patterns.

mx_presentboolean

Set when a cached DNS snapshot exists for the domain (not a mailbox probe).

normalizedstring

policy_actionstring

Team overlay: allow or deny. Omitted when no team policy matched.

public_domainboolean

relay_domainboolean

relay_providerstring

role_addressboolean

subaddressingboolean

suggested_actionstring

Customer-policy action: allow or block. Omitted when no team policy matched.

suggested_domainstring

Corrected domain candidate when a domain or TLD typo rule matches.

suggested_emailstring

Corrected email candidate when a domain or TLD typo rule matches.

syntax_validationboolean

wildcard_dnsboolean

True when the domain answers wildcard DNS typical of temp-mail farms.

messagestring

Human-readable detail when the code is not SUCCESS.

400

Bad Request

codestringrequired

Machine-readable status code (for example SUCCESS or INVALID_BODY).

messagestring

Human-readable detail when the code is not SUCCESS.

401

Unauthorized

codestringrequired

Machine-readable status code (for example SUCCESS or INVALID_BODY).

messagestring

Human-readable detail when the code is not SUCCESS.

403

Forbidden

codestringrequired

Machine-readable status code (for example SUCCESS or INVALID_BODY).

messagestring

Human-readable detail when the code is not SUCCESS.