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.
- Using this endpoint to check DCV resets and restarts the DCV polling for automatic domain control validation.
- To check the DCV for a pending TLS/SSL certificate order or for an DV TLS certificate order, use the Check domain DCV endpoint.
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
| Name | Req/Opt | Description |
|---|---|---|
| domain_id | required | ID of the domain you want to validate. |
Response parameters
| Name | Type | Description |
|---|---|---|
| status | string | Status of the domain. Possible values:active, inactive |
Was this page helpful?
Provide feedback