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

Example 1. cURL

curl --request POST 'https://www.digicert.com/services/v2/domain/{{domain_id}}/validation' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "validations": [
    {
      "type": "ov"
    },
    {
      "type": "ev"
    }
  ]
}'

Example 2. Python

import requests

url = "https://www.digicert.com/services/v2/domain/{{domain_id}}/validation"

payload = "{\n\t\"validations\": [\n\t\t\t{\n\t\t\t\t\"type\": \"ov\"\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"type\": \"ev\"\n\t\t\t}\n\t\t]\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Example 3. Go

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/domain/{{domain_id}}/validation"

	payload := strings.NewReader("{\n\t\"validations\": [\n\t\t\t{\n\t\t\t\t\"type\": \"ov\"\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"type\": \"ev\"\n\t\t\t}\n\t\t]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Example 4. NodeJS

var request = require("request");

var options = { method: 'POST',
  url: 'https://www.digicert.com/services/v2/domain/{{domain_id}}/validation',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: { validations: [ { type: 'ov' }, { type: 'ev' } ] },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

Example 5. 204 No Content

// empty

Example 6. 201 Created (email)

{
    "id": 112233,
    "validation_emails": {
        "name_scope": "example.com",
        "base_emails": [
            "administrator@example.com",
            "postmaster@example.com",
            "admin@example.com",
            "webmaster@example.com",
            "hostmaster@example.com"
        ]
    }
}

Example 7. 201 Created (dns-txt-token)

{
    "id": 112233,
    "dcv_token": {
        "token": "{{random_value}}",
        "expiration_date": "2020-02-21T06:29:24+00:00"
    }
}

Example 8. 201 Created (dns-cname-token)

{
    "id": 112233,
    "dcv_token": {
        "token": "{{random_value}}",
        "expiration_date": "2020-02-21T07:01:29+00:00",
        "verification_value": "dcv.digicert.com"
    }
}

Example 9. 201 Created (http-token)

{
    "id": 112233,
    "dcv_token": {
        "token": "{{random_value}}",
        "expiration_date": "2020-02-21T07:01:29+00:00",
        "http_token_url": "http://example.com/.well-known/pki-validation/fileauth.txt"
    }
}

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	When `dcv_method` is `email`, limit who receives verification DCV emails to addresses in this list. Ignored for other DCV methods. Each email address must be a valid constructed email address for the domain or an address for a contact from the domain’s WHOIS or DNS TXT record. Other email addresses are ignored. Your CertCentral account settings^* configure the addresses you can choose from when limiting verification DCV email recipients. If none of the emails you provide are configured to receive verification DCV emails, or if you omit the `email_array` parameter from your request, DigiCert sends emails to all constructed email addresses, WHOIS contacts, and DNS TXT record emails for the domain. ^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
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	Complete list of email addresses you can choose from when limiting who receives DCV emails for the domain. Configure this list in your CertCentral account.^* The `email_array` response parameter is only returned if you changed the default settings for which email addresses can receive verification DCV emails for your account. ^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.
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.

In this section: