OV/EV SSL: Verifica DCV


Use this endpoint to check the domain control validation (DCV) for a pending domain submitted for prevalidation or as part of an OV/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 DV certificate order, use the DV SSL: Check DCV endpoint.

Using this endpoint to check DCV does not reset or restart the polling interval for automatic domain control validation.

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)

package main

import (

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)


var request = require("request");

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

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

200 OK
    "token": "36m5kkf95gx4nwz",
    "status": "active"
400 (dns-txt-token)
  "errors": [
      "code": "invalid_dns_txt",
      "message": "Could not find a valid TXT record for one or more domains."
400 (http-token)
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."
400 (dns-cname-token)
  "errors": [
      "code": " invalid_dns_cname",
      "message": "Requested domain does not have a valid cname."
400 (email)
  "errors": [
      "code": "invalid_dns_method",
      "message": "An error occurred while processing your request."

Path parameters

Name Req/Opt Description
domain_id required ID of the domain you want to validate.

Response parameters

Name Type Description
token int Random value used to validate control over the domain.
status string Status of the domain.
Possible values: active, inactive