All Products
Search
Document Center

Direct Mail:How to use the email address validation API?

Last Updated:Jun 22, 2026

DirectMail provides APIs to validate email addresses individually or in batches, helping you verify address validity before sending.

Feature description

Email address validation

API examples

Note
  • GetValidationQuota: Retrieves the email validation quota.

  • ValidateEmail: Validates a single email address.

  • Batch address processing order:

    1. SendValidateFile: Upload the list of addresses to validate.

    2. GetValidateFileStatus: Retrieve the validation file status.

    3. GetValidateFile: Retrieve the result file of the batch validation task.

    4. DeleteValidateFile: Delete the validation file after validation completes.

For API documentation and testing, see Email address validation APIs.

GetValidationQuota: Retrieves the email validation quota.

image

ValidateEmail: Validates a single email address.

image

Hover over an enumeration value to view its description.

image

Batch call examples

1. SendValidateFile

Upload the list of addresses to validate.

image

2. GetValidateFileStatus

Retrieve the status of the validation file.

image

3. GetValidateFile

Retrieve the result file of the batch validation task.

image

The file is downloaded from the returned URL.image

4. DeleteValidateFile

After validation completes, delete the validation file.

image

The file cannot be retrieved after it is deleted.image