Use this endpoint to get the validation status of an order. Response data varies depending on the type of certificate and the status of the validation components.
curl -X GET \
'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/validation' \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}'
import requests
url = "https://www.digicert.com/services/v2/order/certificate/{{order_id}}/validation"
payload = ""
headers = {
'X-DC-DEVKEY': "{{api_key}}",
'Content-Type': "application/json"
}
response = requests.request("GET", 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/order/certificate/{{order_id}}/validation"
req, _ := http.NewRequest("GET", 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: 'GET',
url: 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/validation',
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);
});
{
"order_id": "112211",
"order_status": "issued",
"organization_id": "12345",
"organization_name": "Example Organization",
"organization_validations": [
{
"type": "ov",
"name": "OV",
"description": "Normal Organization Validation",
"date_created": "2018-04-25T21:52:33+00:00",
"validated_until": "2019-04-25T21:52:33+00:00",
"status": "pending"
"verification_details": {
"organization_type": "pending",
"organization_status": "pending",
"address_verification": "pending",
"blacklist_fraud": "pending",
"request_authenticity": "pending"
}
],
"dns_name_validations": [
{
"domain_id": "1234",
"name_scope": "example.com",
"approval_scope": "subdomains",
"status": "approved",
"method": "email",
"dns_names": [
"sub.example.com"
],
"approval_expiration_date": "2020-09-11T16:27:39+00:00"
}
]
}
Name | Req/Opt | Type | Description |
---|---|---|---|
order_id | required | string | Order ID. |
Name | Type | Description |
---|---|---|
order_id | string | Order ID. |
order_status | string | Status of the order. See Glossary – Order status |
organization_id | string | Organization ID. |
organization_name | string | Organization name. |
organization_validations | array |
List of objects with details about organization validations that must be complete before DigiCert can issue the certificate. Note: The organization_validations array is not returned for DV certificate orders.
|
.. type | string | Validation type ID. See Glossary – Validation types |
.. name | string | Friendly name of the validation type. |
.. description | string | Description of the validation type. |
.. date_created | string | Timestamp when validation was completed. UTC timezone and ISO 8601 date. |
.. validated_until | string | Timestamp when validation will expire. UTC timezone and ISO 8601 date. |
.. status | string |
Validation status. Possible values: pending , active
|
.. verified_contacts | array | List of objects with details about verified contacts for the organization. |
.. .. user_id | string |
Contact user ID. Returns "0" if the verified contact is not a user in your CertCentral account.
|
.. .. name | string | Contact name. |
.. .. first_name | string | Contact first name. |
.. .. last_name | string | Contact last name. |
.. .. job_title | string | Contact job title. |
.. .. telephone | string | Contact telephone number. |
string | Contact email address. | |
.. .. status | string |
Contact approval status. Possible values: pending , active
|
.. verification_details | object | Object containing the status of each component involved in verifying your certificate request. |
.. .. organization_type | string |
Status of verification of organization type. Only returned for OV certificate orders. Possible values: pending , complete
|
.. .. organization_status | string |
Status of verification that the business is still active. Returned for OV, code signing, and doc signing certificate orders. Possible values: pending , complete
|
.. .. address_verification | string |
Status of verification of the legal physical address for the organization. Returned for OV, code signing, and doc signing certificate orders. Possible values: pending , complete
|
.. .. blacklist_fraud | string |
Status of verification that the organization doesn’t appear on "do not issue" lists or "bad actor" lists. Returned for EV, OV, doc signing, and VMC certificate orders. Possible values: pending , complete
|
.. .. blacklist_fraud_malware | string |
Status of verification that the organization is not a known malware signer. Returned for code signing and EV code signing certificate orders. Possible values: pending , complete
|
.. .. request_authenticity | string |
Status of verification that the certificate requestor has authority to order a certificate for the organization. Only returned for OV certificate orders. Possible values: pending , complete
|
.. .. operational_existence | string |
Status of verification that the organization exists and is operational. Returned for EV, EV code signing, and VMC certificate orders. Possible values: pending , complete
|
.. .. place_of_business_verification | string |
Status of verification of the organization’s place of business. Returned for EV, EV code signing, and VMC certificate orders. Possible values: pending , complete
|
.. .. phone_number_verification | string |
Status of verification that the phone number given is valid and tied to the organization. Returned for EV, code signing, EV code signing, and VMC certificate orders. Possible values: pending , complete
|
.. .. approver_verification | string |
Status of verification that the approver is valid for this organization. Returned for EV, code signing, EV code signing, and VMC certificate orders. Possible values: pending , complete
|
.. .. approver_blacklist | string |
Status of verification that the approver doesn’t appear on "do not issue" or "bad actor" lists. Returned for EV, code signing, EV code signing, and VMC certificate orders. Possible values: pending , complete
|
.. .. logo_trademark | string |
Status of verification that the logo is a registered trademark for the organization on the order. Only returned for VMC certificate orders. Possible values: pending , complete
|
dns_name_validations | array | List of objects with validation details for each domain on the order. Returned for EV, OV, DV, and VMC certificate orders. |
.. domain_id | string |
ID of the domain in your account that must be validated to prove control over the hostname in the dns_names array. Returned for OV, EV, and VMC certificate orders.
|
.. name_scope | string | Name scope for the validation. Returned for OV and EV certificate orders. Only returned if the domain is validated. |
.. approval_scope | string |
Approval scope for the validated domain. Returned for OV and EV certificate orders. Only returned if validation status is approved .
|
.. status | string |
Validation status. Possible values: approved , unapproved
|
.. method | string |
DCV method used for the validated domain. Returned for DV, OV, EV, and VMC certificate orders. Note: Only returned for OV, EV, and VMC certificate orders if validation status is approved .
|
.. dns_names | array |
List containing the SAN from the certificate order associated with the validation details in the dns_name_validations object.
|
.. approval_expiration_date | string |
Date and time validation expires. UTC timezone and ISO 8601 date. Only returned if validation status is approved .
|
.. base_domain | string |
Base domain of the hostname in the dns_names array.
|