get

Detect email characteristics

Analyzes an email for syntax, normalization, typo suggestions, role/public/relay/disposable signals. 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 when a disposable verdict includes a confidence signal.

detection_sourcestring

disposableboolean

disposable_providerstring

domainstring

emailstring

normalizedstring

public_domainboolean

relay_domainboolean

relay_providerstring

role_addressboolean

subaddressingboolean

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

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.