---
title: "Validate email addresses"
method: POST
path: "/doGlobalEmail"
tags: ["Email Validation"]
---

# Validate email addresses

`POST /doGlobalEmail`

Use this endpoint to verify email addresses in batch.

## Headers

- `Accept` 'application/json' | '*/*', required
- `Content-Type` 'application/json' | 'application/xml', required

## Request body

- GlobalEmailRequest
  - `CustomerID` string, required — Required. The [License Key](https://docs.melissa.com/melissa/license/license-information.html) issued by Melissa.
  - `Options` string — [Options](https://docs.melissa.com/cloud-api/global-email/global-email-reference-guide.html#options) - List options in the following format, with multiple options delimited with a `,`. `OptionName:Parameter,OptionName:Parameter` - `AllowQuotes:< on | off >` - Allow double-quoted mailbox names. This allows special characters and whitespace within a valid quoted string. Default is `on`. - `BounceCheck:< on | off >` - Conditionally triggers a real-time test message to the mail server for a given mailbox. Default is `off`. - `DomainCorrection:< on | off >` - Activates fuzzy email domain correction if the domain is a suspected typo. Default is `on`. - `TimeToWait:< [5 - 45] >`- Select how long the web service will wait before it times out on an email. Default set to `25`. - `VerifyMailbox:< Express | Premium >` - `Express` - Quickly validates against database of known email addresses. - `Premium` - A real time check is performed to determine email deliverability. This is the default option. - `WhoIsLookup:< on | off >` - Activates domain information Lookups. Default is `on`.
  - `Records` object[], required
    - `Email` string — Required. The email address to be verified.
    - `RecordID` string — A unique identifier for the record.
  - `TransmissionReference` string — Serves as a unique request identifier.

## Response `200`

Successful response

- GlobalEmailResponse
  - `Version` string — The current service version number.
  - `TransmissionReference` string — A pass-through of the input TransmissionReference field.
  - `TransmissionResults` string — Lists error codes from any errors caused by the most recent request as a whole. For more information, see [Global Email Result Codes](https://docs.melissa.com/cloud-api/global-email/result-codes.html).
  - `TotalRecords` string — Total number of records.
  - `Records` object[]
    - `RecordID` string — The number of the record. Always 1 for a single email request, otherwise it serves as an index of the array of records.
    - `DeliverabilityConfidenceScore` string — The probability [`0-100`]% of an email sent to this mailbox will be successfully delivered.
    - `Results` string — Comma delimited status, error codes, and change codes for the record.
    - `EmailAddress` string — The email address or domain, including any corrections or updates made by Global Email.
    - `MailboxName` string — The mailbox or user name portion of the email address (Everything before the `@` in the email address).
    - `DomainName` string — The domain name portion of the email address. (All characters between the `@` and `.` characters.).
    - `DomainAuthenticationStatus` string — The security protocols used on the receiving mail server.
    - `TopLevelDomain` string — The description associated with the top-level domain name of the email address (e.g. com is Commercial).
    - `TopLevelDomainName` string — The top level domain name portion of the email address (All characters after the `.`, e.g. com).
    - `DateChecked` string — The date the email was validated. It returns UTC, Unix Time (Epoch Time) in the `MM/DD/YYYY H:MM:SS` format.
    - `EmailAgeEstimated` string — The estimated minimum age of the email in days based on historical data. The value is zero when we lack historical data on a given email.
    - `DomainAgeEstimated` string — The estimated age of the domain in days.
    - `DomainExpirationDate` string — The date the domain expires/expired in the `YYYY-MM-DDTHH:MM:SS` format. This is When the domain will be renewed or available to buy.
    - `DomainCreatedDate` string — The date the domain was created in the `YYYY-MM-DDTHH:MM:SS` format.
    - `DomainUpdatedDate` string — The date the domain was last updated in the `YYYY-MM-DDTHH:MM:SS` format.
    - `DomainEmail` string — The email associated with the domain owner.
    - `DomainOrganization` string — The company associated with the domain owner.
    - `DomainAddress1` string — The address of the DomainOrganization.
    - `DomainLocality` string — The city of the DomainOrganization.
    - `DomainAdministrativeArea` string — The state of the DomainOrganization.
    - `DomainPostalCode` string — The postal code of the DomainOrganization.
    - `DomainCountry` string — The country of the DomainOrganization.
    - `DomainCountryCode` string — The country code of the DomainCountry.
    - `DomainAvailability` string — Check to see if domain is available for purchase.
    - `DomainPrivateProxy` string — Check if domain is behind a private proxy.
    - `PrivacyFlag` string — Is this email affected by additional privacy regulations, such as GDPR. Returns `Y` for yes and `N` for no.
    - `MXServer` string — Premium only. The Mail Exchange (MX) Server used to validate the email.
    - `DomainTypeIndicator` string — Predicts if email belongs to a personal or business/organization email by analyzing the domain.
    - `BreachCount` string — The known number of breaches that this email account has been involved in.
    - `ActivityLevel` string — The associated historical internet activity level for the email address. As a beta feature, behavior may change as improvements are made.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/melissa/apis/global-email.md) · [All operations](https://skmtc.net/melissa/apis/global-email/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/global-email/versions/ddea69794928/schema)