OV/EV SSL: Check DCV
2 minute read
PUT
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 https://www.digicert.com/services/v2/domain/{{domain_id}}/dcv/validate-token
dns-txt-token, http-token, or dns-cname-token.Note
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
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);
});{
"token": "36m5kkf95gx4nwz",
"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
| 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 |
Was this page helpful?
Provide feedback