CheckResult

CompanyEmailVerificationBusinessToolsAPIEUHosted

Properties

Name	Type	Description
email	stringnull	The address as sent (null for domain and URL checks).
url	string	Only for URL checks: the website address as sent. Its host (without www.) is the checked domain.
normalized_email	stringnull	Lowercased, IDN-normalised, +tag removed.
domain	stringnull
is_business	boolean	True for business, education and government.
category	string
confidence	number
recommendation	string
policy	string
is_free_provider	boolean
is_disposable	boolean
is_relay	boolean
is_role_account	boolean
shared_inbox	object	Hint that the address is a shared inbox: one mailbox several people answer from (a Microsoft 365 shared mailbox, a Google collaborative inbox, a helpdesk address) such as support@ or billing@. Only th
group	object	Hint that the address is a group that forwards to many members (a Google Group, a Microsoft 365 group or distribution list) such as team@ or all@. 0.3 (low) on a name match, 1 for @googlegroups.com, 0
is_blocked	boolean
is_new_domain	boolean
is_lookalike	boolean
has_subaddress	boolean
did_you_mean	stringnull	Suggested domain for a likely typo.
mail	object
workspace	object
integrations	object
domain_age_days	integernull
reasons	array	See https://isbusinessemail.com/docs/reason-codes
degraded	boolean	DNS was unavailable; the verdict is from lists only.
cached	boolean
took_ms	integer
request_id	string

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/isbusinessemail/main/json-schema/isbusinessemail-check-result-schema.json",
  "title": "CheckResult",
  "x-generated": "2026-10-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/isbusinessemail-openapi.json#/components/schemas/CheckResult",
  "type": "object",
  "required": [
    "domain",
    "is_business",
    "category",
    "confidence",
    "recommendation",
    "reasons"
  ],
  "properties": {
    "email": {
      "type": [
        "string",
        "null"
      ],
      "description": "The address as sent (null for domain and URL checks)."
    },
    "url": {
      "type": "string",
      "description": "Only for URL checks: the website address as sent. Its host (without www.) is the checked domain."
    },
    "normalized_email": {
      "type": [
        "string",
        "null"
      ],
      "description": "Lowercased, IDN-normalised, +tag removed."
    },
    "domain": {
      "type": [
        "string",
        "null"
      ]
    },
    "is_business": {
      "type": "boolean",
      "description": "True for business, education and government."
    },
    "category": {
      "type": "string",
      "enum": [
        "business",
        "personal",
        "disposable",
        "relay",
        "education",
        "government",
        "invalid",
        "unknown"
      ]
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "recommendation": {
      "type": "string",
      "enum": [
        "allow",
        "review",
        "block"
      ]
    },
    "policy": {
      "type": "string",
      "enum": [
        "b2b",
        "strict",
        "lenient"
      ]
    },
    "is_free_provider": {
      "type": "boolean"
    },
    "is_disposable": {
      "type": "boolean"
    },
    "is_relay": {
      "type": "boolean"
    },
    "is_role_account": {
      "type": "boolean"
    },
    "shared_inbox": {
      "type": "object",
      "description": "Hint that the address is a shared inbox: one mailbox several people answer from (a Microsoft 365 shared mailbox, a Google collaborative inbox, a helpdesk address) such as support@ or billing@. Only the name is evidence: 0.3 (low) on a match, 0 otherwise. Never changes the recommendation.",
      "properties": {
        "confidence": {
          "type": "number",
          "enum": [
            0,
            0.3,
            1
          ]
        },
        "match": {
          "type": [
            "string",
            "null"
          ],
          "description": "The word that matched, or googlegroups.com."
        }
      }
    },
    "group": {
      "type": "object",
      "description": "Hint that the address is a group that forwards to many members (a Google Group, a Microsoft 365 group or distribution list) such as team@ or all@. 0.3 (low) on a name match, 1 for @googlegroups.com, 0 otherwise. Never changes the recommendation.",
      "properties": {
        "confidence": {
          "type": "number",
          "enum": [
            0,
            0.3,
            1
          ]
        },
        "match": {
          "type": [
            "string",
            "null"
          ],
          "description": "The word that matched, or googlegroups.com."
        }
      }
    },
    "is_blocked": {
      "type": "boolean"
    },
    "is_new_domain": {
      "type": "boolean"
    },
    "is_lookalike": {
      "type": "boolean"
    },
    "has_subaddress": {
      "type": "boolean"
    },
    "did_you_mean": {
      "type": [
        "string",
        "null"
      ],
      "description": "Suggested domain for a likely typo."
    },
    "mail": {
      "type": "object",
      "properties": {
        "has_mx": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "provider": {
          "type": [
            "string",
            "null"
          ]
        },
        "mx": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "priority": {
                "type": "integer"
              },
              "host": {
                "type": "string"
              },
              "provider": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "spf": {
          "type": [
            "string",
            "null"
          ]
        },
        "dmarc_policy": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "none",
            "quarantine",
            "reject",
            null
          ]
        }
      }
    },
    "workspace": {
      "type": "object",
      "properties": {
        "google_workspace": {
          "type": "object",
          "properties": {
            "detected": {
              "type": "boolean"
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "microsoft_365": {
          "type": "object",
          "properties": {
            "detected": {
              "type": "boolean"
            },
            "tenant_id": {
              "type": [
                "string",
                "null"
              ],
              "format": "uuid"
            },
            "tenant_region": {
              "type": [
                "string",
                "null"
              ]
            },
            "auth": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "managed",
                "federated",
                null
              ]
            },
            "identity_provider": {
              "type": [
                "string",
                "null"
              ]
            },
            "evidence": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "other_suite": {
          "type": [
            "string",
            "null"
          ]
        },
        "pending": {
          "type": "boolean"
        }
      }
    },
    "integrations": {
      "type": "object",
      "properties": {
        "google_workspace_ready": {
          "type": "boolean"
        },
        "microsoft_365_ready": {
          "type": "boolean"
        }
      }
    },
    "domain_age_days": {
      "type": [
        "integer",
        "null"
      ]
    },
    "reasons": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "See https://isbusinessemail.com/docs/reason-codes"
    },
    "degraded": {
      "type": "boolean",
      "description": "DNS was unavailable; the verdict is from lists only."
    },
    "cached": {
      "type": "boolean"
    },
    "took_ms": {
      "type": "integer"
    },
    "request_id": {
      "type": "string"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/isbusinessemail-check-result"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.