Check domain DCV

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.

Notice

To check the DCV for a pending TLS/SSL certificate order, use the Check order DCV endpoint.

Note

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

Example requests and responses

Example 1. cURL

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}}'

Example 2. Python

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)

Example 3. Go

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

}

Example 4. NodeJS

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

Example 5. 200 OK

{
    "token": "36m5kkf95gx4nwz",
    "status": "active"
}

Example 6. 400 Bad Request (dns-txt-token)

{
  "errors": [
    {
      "code": "invalid_dns_txt",
      "message": "Could not find a valid TXT record for one or more domains."
    }
  ]
}

Example 7. 400 Bad Request (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."
    }
  ]
}

Example 8. 400 Bad Request (dns-cname-token)

{
  "errors": [
    {
      "code": " invalid_dns_cname",
      "message": "Requested domain does not have a valid cname."
    }
  ]
}

Example 9. 400 Bad Request (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`

Name

Type

Description

token

int

Random value used to validate control over the domain.

status

string

Status of the domain.

Possible values:active, inactive

In this section: