Skip to main content

Domain emails

GET https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/emails

Use this endpoint to get the email addresses that receive validation emails from DigiCert for the email domain control validation (DCV) method.

Example requests and responses

Path parameters

Name

Req/Opt

Description

domain_id

required

ID of the domain to get DCV email addresses for.

To get the ID of a domain, use the List domains endpoint. To get the DCV email addresses for any domain in your account without using the domain ID, replace domain_id with the FQDN.

URL query parameters

Name

Req/Opt

Type

Description

consider_dcv_email_preferences

optional

bool

If true, response only includes email addresses your CertCentral account settings* allow you to choose from when limiting who receives DCV emails for the domain. This means:

  • The base_emails array only includes constructed emails that are selected in your account settings*.

  • The response only includes the whois_emails and dns_txt_emails arrays if the WHOIS and DNS TXT contact types are selected in your account settings*.

If false (default), response includes all possible DCV email recipients for the domain, regardless of your account settings. In this case, the base_emails array includes all constructed emails for the domain, and the response includes all contacts found on the domain's WHOIS (whois_emails) and DNS TXT (dns_txt_emails) records.

*To view your account settings, in the left main menu, go to Settings > Preferences. Then, on the Preferences page, expand Advanced Settings, and look under Send Verification DCV Emails to.

Response parameters

Name

Type

Description

name_scope

string

Domain name scope of the email addresses.

base_emails

array

List of constructed email addresses for the domain.

whois_emails

array

List of email addresses found on the WHOIS record of the domain.

dns_txt_emails

array

List of email addresses found in the DNS TXT record for the domain.

Note: These are the email addresses we find in the DNS TXT record on the _validation-contactemail subdomain of the domain being validated. For more information about using contacts from DNS TXT records for DCV checks, see the following topics:

email_array

array