---
title: "Verify a single email address"
method: GET
path: "/real-time/"
tags: ["Email Verification"]
---

# Verify a single email address

`GET /real-time/`

## Request

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

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.

## Query parameters

- `key` string, required
- `email` string, email, required
- `xml` 'true'
- `label` string

## Response `200`

Successful verification response. The `status` field indicates the outcome.

- VerificationResponse
  - `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.
  - `details` string: Human-readable description of the validation result.
  - `email` string: The email address that was validated.
  - `emailSuggested` string: Suggested correction if a typo was detected (e.g., gnail.com -> gmail.com). Empty string if no suggestion.
  - `mailbox` string: The local part of the email address (before @).
  - `domain` string: The domain part of the email address (after @).
  - `isComplainer` boolean: True if the address is known to frequently report emails as spam.
  - `isDisposable` boolean: True if the address uses a disposable or temporary email service (e.g., Mailinator, 10MinuteMail).
  - `isFreeService` boolean: True if the address is from a free email provider (e.g., Gmail, Yahoo, Outlook).
  - `isGibberish` boolean: True if the local part of the email appears to be random or meaningless characters.
  - `isOffensive` boolean: True if the address contains offensive or inappropriate words.
  - `isRoleAccount` boolean: True if the address is a role account (e.g., info@, admin@, support@, sales@).
  - `timestampUTC` string, date-time: UTC timestamp of when the validation occurred (ISO 8601 format).
  - `execution` string: Time taken to validate the address in seconds.
  - `creditsRemaining` integer: Number of verification credits remaining in your account.
  - `hourlyQuotaRemaining` integer: Number of API requests remaining in your current hourly window.
  - `mxEnrichment` MxEnrichment: Detailed information about the recipient's mail server. Included free with every verification response.
    - `mxIp` string: Primary MX server IP address.
    - `mxHostname` string: Primary MX server hostname.
    - `mxCity` string: City where the MX server is located (if available).
    - `mxPostalCode` string: Postal code of the MX server location (if available).
    - `mxState` string: State or region where the MX server is located.
    - `mxStateISOCode` string: ISO 3166-2 state/region code (e.g., TX for Texas).
    - `mxCountry` string: Country where the MX server is located.
    - `mxCountryISOCode` string: ISO 3166-1 alpha-2 country code.
    - `mxContinent` string: Continent where the MX server is located.
    - `mxContinentISOCode` string: Continent code (NA, EU, AS, AF, OC, SA, AN).
    - `mxTimezone` string: IANA timezone of the MX server location.
    - `mxLatitude` string: Latitude coordinate of the MX server.
    - `mxLongitude` string: Longitude coordinate of the MX server.
    - `mxIsp` string: Internet Service Provider hosting the MX server.
    - `mxIspOrganization` string: Organization name of the ISP.
    - `mxAsn` integer: Autonomous System Number of the MX server's network.
    - `mxAsnOrganization` string: Organization name associated with the ASN.
    - `mxIps` string[]: All MX server IP addresses for the domain.
    - `mxHostnames` string[]: All MX server hostnames for the domain, ordered by priority.

## Other responses

- `429`: Rate limit exceeded. You have exceeded your hourly quota or concurrent thread limit. Implement exponential back-off and retry after 1-2 seconds.

---

[API](https://skmtc.dev/bulkemailchecker/apis/bulk-email-checker-api.md) · [All operations](https://skmtc.dev/bulkemailchecker/apis/bulk-email-checker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bulkemailchecker/apis/bulk-email-checker-api/revisions/8aba44f27ea4?raw)