Mailcheck.ing API Documentation

Welcome to the Mailcheck.ing API. This API allows you to verify email addresses to check their validity, domain details, SMTP server status, check data breaches, and more.

API Information

• API Version: 1.0
• Base URL: https://api.mailcheck.ing

Authentication

For Authentication, use Authorization header

curl "URL" \
  -H "Authorization: <API-KEY>"

To access the Mailcheck.ing API, you must provide your authentication credentials in the request header.

• Header Name: Authorization
• Type: string
• Required: Yes

Endpoints

Sample request: POST https://api.mailcheck.ing/v1/verify

curl -X 'POST' \
  'https://api.mailcheck.ing/v1/verify' \
  -H 'accept: application/json' \
  -H 'Authorization: <API_KEY_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
  "check_breach": true,
  "email": "string",
  "verify": true
}'

Verify Email Address

Verifies the provided email address with optional breach and verification checks.

• URL: /v1/verify
• Method: POST
• Content-Type: application/json
• Authorization: Required

Request Parameters

• check_breach: Flag to enable breach check. If true, then a breach check will be performed.
• email: The email address to verify.
• verify: Flag to enable verification check. If true, then Syntax, MX, SMTP, CatchAll checks will be performed.

Request Example

{ "check_breach": true, "email": "[email protected]", "verify": true }

Responses

Sample 200 Response

{
  "email": "[email protected]",
  "reachable": "no",
  "syntax": {
    "username": "test",
    "domain": "gmail.com",
    "valid": true
  },
  "smtp": {
    "host_exists": true,
    "full_inbox": false,
    "catch_all": false,
    "deliverable": false,
    "disabled": false
  },
  "gravatar": {
    "gravatarUrl": "https://gravatar.com/example",
    "hasGravatar": true
    },
  "suggestion": "",
  "disposable": false,
  "role_account": true,
  "free": true,
  "mx": {
    "HasMXRecord": true,
    "Records": [
      {
        "Host": "gmail-smtp-in.l.google.com.",
        "Pref": 5
      },
      {
        "Host": "alt1.gmail-smtp-in.l.google.com.",
        "Pref": 10
      },
      {
        "Host": "alt2.gmail-smtp-in.l.google.com.",
        "Pref": 20
      },
      {
        "Host": "alt3.gmail-smtp-in.l.google.com.",
        "Pref": 30
      },
      {
        "Host": "alt4.gmail-smtp-in.l.google.com.",
        "Pref": 40
      }
    ]
  },
  "breach": {
    "found": false,
    "details": []
  }
}

200 OK

Successful response with details about the email verification.

Response Attributes

• breach: Details about the breach, if any.
• disposable: Indicates if the email is from a disposable email provider.
• email: The email address that was verified.
• free: Indicates if the domain is a free email domain.
• gravatar: Details about the Gravatar associated with the email.
• mx: Details about the MX records of the domain.
• reachable: Describes whether the recipient address is real.
• role_account: Indicates if the account is role-based.
• smtp: Details about the SMTP response of the email.
• suggestion: Suggested domain if the original domain is misspelled.
• syntax: Details about the email address syntax.

400 Bad Request

The request was invalid or cannot be served.

401 Unauthorized

Authentication credentials were missing or incorrect.

500 Internal Server Error

Something went wrong on the server.

Result

Definitions

Breach

Breach.Details

Gravatar

Mx

Mx.Records

SMTP

Syntax

Contact

For any additional information or support, please contact the [email protected]