Email Verification

Verify a single email address (POST)

Identical to the GET endpoint but accepts parameters via POST body with application/x-www-form-urlencoded content type. Useful when email addresses contain special characters or when GET query string length limits are a concern.

post/real-time/

Request

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

Response

Successful verification response.

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.