Skip to main content

Submit domain for validation

POST https://www.digicert.com/services/v2/domain/{{domain_id}}/validation

Use this endpoint to submit a domain to be validated for the specified validation types.

After you submit a domain for validation, you can get the DCV token for the domain by using the Domain info endpoint. Additionally, you can generate a new DCV token by using the Generate domain DCV random value endpoint.

Notice

Include the optional dcv_method parameter to specify the DCV method to used when proving control over the domain.

Example requests and responses

Request parameters

Name

Req/Opt

Type

Description

validations

required

array of objects

List of validation types to submit the domain for.

.. type

required

string

Validation type identifier. See Glossary – Validation types.

dcv_method

optional

string

DCV method to use for the domain. See Glossary – DCV methods.

email_array

optional

array of strings

Response parameters

Name

Type

Description

id

integer

ID of the added domain.

validation_emails

object

Email addresses used when sending DCV emails. Only returned for email DCV method.

.. name_scope

string

Domain scope used for WHOIS record and constructed email addresses.

.. base_emails

array of strings

List of constructed email addresses.

.. whois_emails

array of strings

List of email addresses on WHOIS record.

.. email_array

array of strings

dcv_token

object

DCV token details. Only returned for dns-txt-token, dns-cname-token, and http-token DCV methods.

.. token

string

Random value to use for DCV validation.

.. status

string

DCV status.

Possible values: pending, active

.. expiration_date

string

Timestamp for when the token expires.

Format: UTC timezone and ISO 8601 date

.. verification_value

string

Value for the CNAME record's host field (or equivalent). Only returned for dns-cname-token DCV method.

.. http_token_url

string

Filename of the text file and where it should be placed on the web server. Only returned for http-token DCV method.