# Validate email addresses

Endpoint: POST /doGlobalEmail

## Request fields (application/json):

  - `CustomerID` (string, required)
    The [License Key](https://docs.melissa.com/melissa/license/license-information.html) issued by Melissa.

  - `Format` (string)
    Specify the desired format of the response (XML or JSON).
    Enum: "JSON", "XML"

  - `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: - Allow double-quoted mailbox names. This allows special characters and whitespace within a valid quoted string. Default is on.
- DomainCorrection: - Activates fuzzy email domain correction if the domain is a suspected typo. Default is on.
- TimeToWait:- Select how long the web service will wait before it times out on an email. Default set to 25.
- VerifyMailbox:
  - Express - Quickly validates against database of known email addresses. This is the default option.
  - Premium - A real time check is performed to determine email deliverability.
- WhoIsLookup: - Activates domain information Lookups. Default is on.

  - `Records` (array, required)

  - `Records.Email` (string)
    The email address to be verified.

  - `Records.RecordID` (string)
    Unique identifier for the record.

  - `TransmissionReference` (string)
    Transmission Reference - Serves as a unique request identifier.

## Response 200 fields (application/json):

  - `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` (array)

  - `Records.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.

  - `Records.DeliverabilityConfidenceScore` (string)
    The probability [0-100]% of an email sent to this mailbox will be successfully delivered.

  - `Records.Results` (string)
    Comma delimited status, error codes, and change codes for the record.

  - `Records.EmailAddress` (string)
    The email address or domain, including any corrections or updates made by Global Email.

  - `Records.MailboxName` (string)
    The mailbox or user name portion of the email address (Everything before the @ in the email address).

  - `Records.DomainName` (string)
    The domain name portion of the email address. (All characters between the @ and . characters.).

  - `Records.DomainAuthenticationStatus` (string)
    The security protocols used on the receiving mail server.

  - `Records.TopLevelDomain` (string)
    The description associated with the top-level domain name of the email address (e.g. com is Commercial).

  - `Records.TopLevelDomainName` (string)
    The top level domain name portion of the email address (All characters after the ., e.g. com).

  - `Records.DateChecked` (string)
    The date the email was validated. It returns UTC, Unix Time (Epoch Time) in the MM/DD/YYYY H:MM:SS format.

  - `Records.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.

  - `Records.DomainAgeEstimated` (string)
    The estimated age of the domain in days.

  - `Records.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.

  - `Records.DomainCreatedDate` (string)
    The date the domain was created in the YYYY-MM-DDTHH:MM:SS format.

  - `Records.DomainUpdatedDate` (string)
    The date the domain was last updated in the YYYY-MM-DDTHH:MM:SS format.

  - `Records.DomainEmail` (string)
    The email associated with the domain owner.

  - `Records.DomainOrganization` (string)
    The company associated with the domain owner.

  - `Records.DomainAddress1` (string)
    The address of the DomainOrganization.

  - `Records.DomainLocality` (string)
    The city of the DomainOrganization.

  - `Records.DomainAdministrativeArea` (string)
    The state of the DomainOrganization.

  - `Records.DomainPostalCode` (string)
    The postal code of the DomainOrganization.

  - `Records.DomainCountry` (string)
    The country of the DomainOrganization.

  - `Records.DomainCountryCode` (string)
    The country code of the DomainCountry.

  - `Records.DomainAvailability` (string)
    Check to see if domain is available for purchase.

  - `Records.DomainPrivateProxy` (string)
    Check if domain is behind a private proxy.

  - `Records.PrivacyFlag` (string)
    Is this email affected by additional privacy regulations, such as GDPR. Returns Y for yes and N for no.

  - `Records.MXServer` (string)
    Premium only. The Mail Exchange (MX) Server used to validate the email.

  - `Records.DomainTypeIndicator` (string)
    Predicts if email belongs to a personal or business/organization email by analyzing the domain.

  - `Records.BreachCount` (string)
    The known number of breaches that this email account has been involved in.

## Response 400 fields (application/json):

  - `type` (string)
    The type of error that occurred.

  - `title` (string)
    A short summary of the error.

  - `status` (integer)
    The HTTP status code for the error.

  - `errors` (object)

  - `errors.$.<PropertyName>` (array)
    A detailed message about the error.

  - `traceId` (string)
    A unique identifier for the request, useful for debugging.