Post Request Parameters

Note: Maximum number of records in a Micro-batch POST request is limited to 10.
This section describes query parameters.
Parameter Description
bogus

Specifies whether to check if the email address is fictitious. For example, bgates@microsoft.com.

true

Perform this check. Default.

False

Do not perform this check.

complain

Specifies whether to check if the owner of the email address is known to submit spam complaints.

true

Perform this check. Default.

false

Do not perform this check.

disposable

Specifies whether to check if the email address originates from a website that provides temporary email addresses, or if the email address appears to be temporary.

true

Perform this check. Default.

false

Do not perform this check.

atc

One character code controlling the advanced suggestion behavior. The possible values are:

a: Service is running in an aggressive mode. In this case correction of the more popular domain is attempted even if the original domain has valid and working mail servers.

c: Service is running in a conservative suggestion mode. In this case, suggestion is offered based on popularity if the original domain is bad or non-functioning.

n: The algorithm to attempt to suggest a correction based on frequency is turned off. However, suggested corrections for syntax errors and other basic typos are still given.

Note: A suggested email is returned only if the address passes the deliverability portion of check completely.

For example, since renee@icloud.com is a deliverable address, it is returned in the SUGG_EMAIL field. If the email address with the suggested domain does not pass the deliverability check, the SUGG_EMAIL is not provided and the SUGG_COMMENT field is populated with the comment suggestion not SafeToDeliver.

This service is designed for a real-time environment where the individual doing the keystroking gets instant feedback on the problems found with the given email address. The proposed suggestions are offered for human confirmation.

Note: If your integration does not allow this, set the value for this option to c.
emailAddress The email address you want to validate.
emps

Specifies whether to check if the email address appears on the Direct Marketing Association's “Do Not Email" list (Electronic Mail Preference Service).

true

Perform this check. Default.

false

Do not perform this check.

fccwireless

Specifies whether to check if the email address is associated with a domain that has restrictions on commercial email per the FCC.

true

Perform this check. Default.

false

Do not perform this check.

language

Specifies whether to check if the email address handle contains derogatory words.

true

Perform this check. Default.

false

Do not perform this check.

role

Specifies whether to check if the email address has a non-personal handle, such as info@, sales@, or webmaster@. For example, sales@example.com.

true

Perform this check. Default.

false

Do not perform this check.

rtc

Enables or disables real-time confirmation. If the deliverability of an email address cannot be determined via our knowledge base, a real-time confirmation can be attempted.

true

Perform a real-time confirmation if necessary. Default.

false

Do not attempt a real-time confirmation.

rtc_timeout

Specifies the timeout for real-time confirmation. See the description of the rtc parameter. Specify the timeout value in milliseconds. Valid values are 0 to 4000. By default, the system allows 1200 milliseconds for this check.

You can specify a different timeout value with this parameter. We recommend that the timeout be set to the maximum time that can be accommodated, as foreign domains or slow-to-respond mail servers may require additional time.

alias

Specifies whether to check the email alias while generating the output.

Y: Check the email alias

N: Do not check the email alias
Note: Default is N.
If you specify Y, the output field shows email without the alias characters.Example: All these input Email addresses will generate one output hikingfan@gmail.com.
Note: The feature works only on gmail.com.