Mailboxlayer · Schema

mailboxlayer Email Check Result

Successful response payload returned by GET /api/check after verifying a single email address.

EmailEmail VerificationEmail ValidationSMTPMX RecordsCatch-All DetectionDisposable EmailFree Email ProviderRole AddressQuality ScoreAPILayerPublic APIsData QualityAnti-FraudDeliverabilityCommunicationsDeveloper ToolsSecurity

Properties

Name Type Description
email string The email address submitted for verification.
did_you_mean string Suggested email address if a likely typo was detected, otherwise an empty string.
user string The local part (user) of the submitted email address.
domain string The domain part of the submitted email address.
format_valid boolean Whether the email address has valid syntax.
mx_found boolean Whether MX records exist for the domain.
smtp_check boolean Whether the real-time SMTP verification succeeded.
catch_all booleannull Whether the domain is configured as catch-all. Available on paid plans; may be null on Free.
role boolean Whether the address is a role-based address (e.g., support@, admin@).
disposable boolean Whether the domain belongs to a disposable email provider (e.g., mailinator.com).
free boolean Whether the domain belongs to a free email provider (e.g., gmail.com, yahoo.com).
score number Numeric deliverability quality score from 0.0 to 1.0.
View JSON Schema on GitHub

JSON Schema

mailboxlayer-check-result-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/api-evangelist/mailboxlayer/blob/main/json-schema/mailboxlayer-check-result-schema.json",
  "title": "mailboxlayer Email Check Result",
  "description": "Successful response payload returned by GET /api/check after verifying a single email address.",
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "description": "The email address submitted for verification."
    },
    "did_you_mean": {
      "type": "string",
      "description": "Suggested email address if a likely typo was detected, otherwise an empty string."
    },
    "user": {
      "type": "string",
      "description": "The local part (user) of the submitted email address."
    },
    "domain": {
      "type": "string",
      "description": "The domain part of the submitted email address."
    },
    "format_valid": {
      "type": "boolean",
      "description": "Whether the email address has valid syntax."
    },
    "mx_found": {
      "type": "boolean",
      "description": "Whether MX records exist for the domain."
    },
    "smtp_check": {
      "type": "boolean",
      "description": "Whether the real-time SMTP verification succeeded."
    },
    "catch_all": {
      "type": ["boolean", "null"],
      "description": "Whether the domain is configured as catch-all. Available on paid plans; may be null on Free."
    },
    "role": {
      "type": "boolean",
      "description": "Whether the address is a role-based address (e.g., support@, admin@)."
    },
    "disposable": {
      "type": "boolean",
      "description": "Whether the domain belongs to a disposable email provider (e.g., mailinator.com)."
    },
    "free": {
      "type": "boolean",
      "description": "Whether the domain belongs to a free email provider (e.g., gmail.com, yahoo.com)."
    },
    "score": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Numeric deliverability quality score from 0.0 to 1.0."
    }
  },
  "required": [
    "email",
    "user",
    "domain",
    "format_valid",
    "mx_found",
    "smtp_check",
    "role",
    "disposable",
    "free",
    "score"
  ],
  "additionalProperties": false
}

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/mailboxlayer-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.

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