OV/EV SSL: Check DCV

  2 minute read  

PUT https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/validate-token

Use this endpoint to check the domain control validation (DCV) for a pending domain submitted for pre-validation or as part of an OV or EV certificate order request. The domain should be configured to use a DCV method of dns-txt-token, http-token, or dns-cname-token.

To check the DCV for a pending TLS/SSL certificate order, use the Check order DCV endpoint.
Using this endpoint to check DCV does not reset or restart the polling interval for Automatic domain control validation checks.

Example requests and responses

curl -X PUT \
  'https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/validate-token' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
import requests

url = "https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/validate-token"

payload = ""
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

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

print(response.text)
package main

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

func main() {

	url := "https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/validate-token"

	req, _ := http.NewRequest("PUT", url, nil)

	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))

}
var request = require("request");

var options = { method: 'PUT',
  url: 'https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/validate-token',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' } };

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

  console.log(body);
});
{
        "status": "active"
}
{
  "errors": [
    {
      "code": "invalid_dns_txt",
      "message": "Could not find a valid TXT record for one or more domains."
    }
  ]
}
400 (http-token)
{
  "errors": [
    {
      "code": "file_random_value_not_found",
      "message": "Could not find the random value at the expected file location for one or more domains."
    }
  ]
}
{
  "errors": [
    {
      "code": " invalid_dns_cname",
      "message": "Requested domain does not have a valid cname."
    }
  ]
}
{
  "errors": [
    {
      "code": "invalid_dns_method",
      "message": "An error occurred while processing your request."
    }
  ]
}

Path parameters

NameReq/OptDescription
domain_idrequiredID of the domain you want to validate.

Response parameters

NameTypeDescription
statusstringStatus of the domain.
Possible values:active, inactive