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,
    "domain": "temp-mail.org",
    "base_domain": "temp-mail.org",
    "text": "Disposable / temporary domain",
    "reason": "Heuristics x5",
    "risk": 99,
    "is_disposable": true,
    "is_email_forwarder": false,
    "is_public_free": false,
    "is_public_premium": false,
    "is_business_provider": false,
    "is_isp_email": false,
    "is_email_api": false,
    "is_web_hosting_email": false,
    "is_self_hosted": false,
    "is_parked": false,
    "is_role_based_email": false,
    "mx_host": "amir.mx.cloudflare.net",
    "mx_ip": "162.159.205.13",
    "mx_info": "Using MX pointer amir.mx.cloudflare.net from DNS with priority: 15",
    "mx_fallback": false,
    "mx_hosts": [
        "amir.mx.cloudflare.net"
    ],
    "mx_ips": [
        "162.159.205.13"
    ],
    "mx_priorities": {
        "amir.mx.cloudflare.net": 15,
        "isaac.mx.cloudflare.net": 93,
        "linda.mx.cloudflare.net": 30
    },
    "email_provider": "Cloudflare Email Routing",
    "disposable_provider": "temp-mail.org",
    "possible_typo": [],
    "domain_age_days": 5074,
    "domain_created_at": "2012-05-05T00:00:00+00:00",
    "block_status_changed_at": "2020-04-18T22:05:24+00:00"
}

Response Fields Explanation

  • valid (boolean): Indicates if the domain is valid.
  • block (boolean): Indicates if the email/domain should be blocked.
  • domain (string): The domain of the provided email address.
  • base_domain (string): The base/root domain (useful when subdomains are involved).
  • text (string): A description of the result (e.g., "Disposable / temporary domain").
  • reason (string): Provides additional information about the result (e.g., "Heuristics x5").
  • risk (integer): The combined risk score of the domain (0-100).
  • is_disposable (boolean): Indicates if the email domain belongs to a disposable email provider.
  • is_email_forwarder (boolean): Indicates if the domain is an email forwarding service.
  • is_public_free (boolean): Indicates if the domain is a free public email provider (e.g., Gmail, Yahoo).
  • is_public_premium (boolean): Indicates if the domain is a premium public email provider.
  • is_business_provider (boolean): Indicates if the domain is a business email provider (e.g., Google Workspace).
  • is_isp_email (boolean): Indicates if the domain belongs to an ISP email service.
  • is_email_api (boolean): Indicates if the domain uses an email API service (e.g., Mailgun, SendGrid).
  • is_web_hosting_email (boolean): Indicates if the domain uses web hosting email.
  • is_self_hosted (boolean): Indicates if the domain appears to be self-hosted.
  • is_parked (boolean): Indicates if the domain is parked.
  • is_role_based_email (boolean): Indicates if the email is a role-based address (e.g., info@, admin@).
  • mx_host (string): The primary MX (Mail Exchange) host of the domain.
  • mx_ip (string): The IP address of the primary MX host.
  • mx_info (string): Information about the chosen MX host, including DNS details.
  • mx_fallback (boolean): Indicates if the MX record is a fallback.
  • mx_hosts (array): All MX hosts for the domain.
  • mx_ips (array): All IP addresses of the MX hosts.
  • mx_priorities (object): MX hosts mapped to their priority values.
  • email_provider (string): The detected email provider for the domain.
  • disposable_provider (string): The disposable email provider name (if applicable).
  • possible_typo (array): An array of possible typos for the domain (if applicable).
  • domain_age_days (integer): The age of the domain in days.
  • domain_created_at (string): The creation date of the domain.
  • block_status_changed_at (string): The timestamp of when the block status last changed.

Next Steps

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