Validation Services

Email

Validate one or more email addresses and return normalized values together with syntax and domain quality indicators.

Endpoint

POSThttps://{host}:{port}/Egon/api/norm

Headers & authentication

Required request headers and their expected values.

Field	Type	Description
`token`req	String	Authentication token sent in the `token` request header.

Request

Country context and collection of email addresses to validate.

Field	Type	Description
`par`req	Object	Country context for email validation.
`iso2`	String	Country code, ISO 3166-1 alpha-2. One of `iso2` or `iso3` is required.
`iso3`	String	Country code, ISO 3166-1 alpha-3. One of `iso2` or `iso3` is required.
`data`req	Object	Input data to validate
`emails`req	Array	Email addresses to validate
`email`req	String	Email address

Response

Normalized email addresses, validation quality indicators, and system status.

Field	Type	Description
`data`	Object	Normalized and enriched validation output data
`emails`	Array	Normalized email addresses
`email`req	String	Email address
`quality`	Object	Validation quality indicators and score flags
`emails`	Array	Quality indicator results for each email
`flag`	String	Quality flag
`code`	Number	Quality result code
`description`	String	Quality result description
`system`	Object	Request processing status.
`ret_code`	Number	Processing result code. 0 means no blocking error.
`des_ret_code`	String	Human-readable processing result.

On this page

Endpoint
Headers & authentication
Request
Response

Request Example

curl -X POST "https://{host}:{port}/Egon/api/norm" \
  -H "token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "par": {
    "iso3": "ITA"
  },
  "data": {
    "emails": [
      {
        "email": "info@egon.com"
      },
      {
        "email": "info@example.com"
      }
    ]
  }
}'

Endpoint​

Headers & authentication​

Request​

Response​

Endpoint

Headers & authentication

Request

Response