get

Detect email characteristics

Analyzes an email for syntax, normalization, role/public/relay/disposable signals

/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 OK or INVALID_BODY).

detection_sourcestring

disposableboolean

disposable_providerstring

domainstring

emailstring

normalizedstring

public_domainboolean

relay_domainboolean

relay_providerstring

role_addressboolean

subaddressingboolean

syntax_validationboolean

messagestring

Human-readable detail when the code is not OK.

400

Bad Request

codestringrequired

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

messagestring

Human-readable detail when the code is not OK.