Email Verification

Verify a single email address

Validates a single email address in real-time via a GET request. Performs syntax validation, DNS/MX record checks, disposable detection, spam trap screening, role account detection, and a full SMTP handshake. Returns JSON by default; append xml=true for XML output. 1 credit is consumed per passed or failed result. Unknown results consume no credits.

get/real-time/

Request

  • Base URL: https://api.bulkemailchecker.com
  • URL: https://api.bulkemailchecker.com/real-time/
  • Auth: API key in query parameter key

Query parameters

keystring required
Example:YOUR_API_KEY

Your unique API key. Obtain from your account dashboard at https://panel.bulkemailchecker.com/

emailstring email required
Example:example%40gmail.com

The email address to validate. Must be URL encoded.

xml'true'
Example:true

Set to true to receive an XML response instead of the default JSON.

labelstring
Example:Contact%20Form

Custom label for tracking purposes. Failed emails are tagged with this label in your blacklist. URL encode if necessary. Defaults to 'Real-time API'.

Response

Successful verification response. The status field indicates the outcome.

status'passed' | 'failed' | 'unknown'

The top-level result of the verification. passed = valid deliverable address. failed = invalid address (1 credit consumed). unknown = result could not be determined (0 credits consumed).

event'mailbox_exists' | 'mailbox_does_not_exist' | 'mailbox_full' | 'invalid_syntax' | 'domain_does_not_exist' | 'mxserver_does_not_exist' | 'blacklisted_external' | 'blacklisted_failed' | 'blacklisted_domain' | 'is_catchall' | 'is_greylisting' | 'inconclusive'

Detailed event code explaining the verification outcome.

detailsstring

Human-readable description of the validation result.

emailstring

The email address that was validated.

emailSuggestedstring

Suggested correction if a typo was detected (e.g., gnail.com -> gmail.com). Empty string if no suggestion.

mailboxstring

The local part of the email address (before @).

domainstring

The domain part of the email address (after @).

isComplainerboolean

True if the address is known to frequently report emails as spam.

isDisposableboolean

True if the address uses a disposable or temporary email service (e.g., Mailinator, 10MinuteMail).

isFreeServiceboolean

True if the address is from a free email provider (e.g., Gmail, Yahoo, Outlook).

isGibberishboolean

True if the local part of the email appears to be random or meaningless characters.

isOffensiveboolean

True if the address contains offensive or inappropriate words.

isRoleAccountboolean

True if the address is a role account (e.g., info@, admin@, support@, sales@).

timestampUTCstring date-time

UTC timestamp of when the validation occurred (ISO 8601 format).

executionstring

Time taken to validate the address in seconds.

creditsRemaininginteger

Number of verification credits remaining in your account.

hourlyQuotaRemaininginteger

Number of API requests remaining in your current hourly window.

Example response

{
  "status": "passed",
  "event": "mailbox_exists",
  "details": "The address provided passed all tests.",
  "email": "example@gmail.com",
  "mailbox": "example",
  "domain": "gmail.com",
  "isFreeService": true,
  "timestampUTC": "2026-01-22T04:52:08Z",
  "execution": "0.03",
  "creditsRemaining": 99,
  "hourlyQuotaRemaining": 2498,
  "mxEnrichment": {
    "mxIp": "142.250.102.27",
    "mxHostname": "alt4.gmail-smtp-in.l.google.com",
    "mxCity": "Mountain View",
    "mxPostalCode": "94039",
    "mxState": "Texas",
    "mxStateISOCode": "TX",
    "mxCountry": "United States",
    "mxCountryISOCode": "US",
    "mxContinent": "North America",
    "mxContinentISOCode": "NA",
    "mxTimezone": "America/Chicago",
    "mxLatitude": "32.7797",
    "mxLongitude": "-96.8022",
    "mxIsp": "Google Servers",
    "mxIspOrganization": "Google Servers",
    "mxAsn": 15169,
    "mxAsnOrganization": "GOOGLE",
    "mxIps": [
      "142.250.102.27",
      "172.253.116.27",
      "142.251.16.27"
    ],
    "mxHostnames": [
      "alt4.gmail-smtp-in.l.google.com",
      "alt1.gmail-smtp-in.l.google.com",
      "gmail-smtp-in.l.google.com"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.