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 |
.. 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 |
.. token | string | Random value to use for DCV validation. |
.. status | string | DCV status. Possible values: |
.. 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 |
.. http_token_url | string | Filename of the text file and where it should be placed on the web server. Only returned for |