Skip to content

Example JSON Response

This document provides an example of the JSON response returned by the Check-Mail API when validating an email address and determining if it is disposable.

Example Response

{
   "valid": true,
   "block": true,
   "disposable": true,
   "domain": "dxamail.net",
   "text": "Disposable / temporary domain",
   "reason": "Disposable",
   "risk": 91,
   "mx_host": "dxamail.net",
   "possible_typo": [],
   "mx_ip": "94.237.76.21",
   "mx_info": "Using MX pointer dxamail.net from DNS with priority: 0",
   "last_changed_at": "2020-06-11T09:56:02+02:00"
}

Response Fields Explanation

  • valid (boolean): Indicates if the domain is valid.
  • block (boolean): Indicates if the email/domain should be blocked.
  • disposable (boolean): Indicates if the email domain belongs to a disposable email provider.
  • domain (string): The domain of the provided email address.
  • text (string): A description of the result (e.g., "Disposable / temporary domain").
  • reason (string): Provides additional information about the result (e.g., "Disposable").
  • risk (integer): The combined risk score of the domain (0-100).
  • mx_host (string): The MX (Mail Exchange) host of the domain.
  • possible_typo (array): An array of possible typos for the domain (if applicable).
  • mx_ip (string): The IP address of the MX host.
  • mx_info (string): Information about the chosen MX host, including DNS details.
  • last_changed_at (string): The timestamp of when the risk score last changed.

Next Steps

  • Use this response information to build your email validation logic.
  • Refer to the documentation for further details on the API.