Validation status

GET

https://www.digicert.com/services/v2/order/certificate/{{order_id}}/validation

Use this endpoint to get the validation status of an order.

cURL

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

Python

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

}

NodeJS

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

200 OK

{
  "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"
    }
  ]
}

Response parameters

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	Name of the organization.
organization_validations	array	List of organization validations for the organization.
.. 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. Format: UTC timezone and ISO 8601 date
.. validated_until	string	Timestamp when validation will expire. Format: UTC timezone and ISO 8601 date
.. status	string	Validation status. Possible values: `pending`, `active`
.. verification_details	string	Details regarding the components involved in verifying your certificate validation.
.... organization_type	string	Status of verification of organization type. (OV only) Possible values: `pending`, `active`
.... organization_status	string	Status of verification that the business is still active. (OV only) Possible values: `pending`, `active`
.... address_verification	string	Status of verification of the legal physical address for the organization. (OV only) Possible values: `pending`, `active`
.... blacklist_fraud	string	Status of verification that the organization doesn’t appear on any “do not issue” lists or “bad actor lists.” Possible values: `pending`, `active`
.... request authenticity	string	Status of verification that the certificate requestor has authority to order a certificate for the organization. (OV only) Possible values: `pending`, `active`
.... operational_existence	string	Status of verification that the organization actually exists and is operational. (EV only) Possible values: `pending`, `active`
.... place_of_business_verification	string	Status of verification of the organization’s place of business. (EV only) Possible values: `pending`, `active`
.... phone_number_verification	string	Status of verification that the phone number given is valid and tied to the organization. (EV only) Possible values: `pending`, `active`
.... approver_verification	string	Status of verification that the approver is valid for this organization. (EV only) Possible values: `pending`, `active`
.... approver_blacklist	string	Status of verification that the approver is not on any “do not issue” or “bad actor” lists. (EV only) Possible values: `pending`, `active`
dns_name_validations	array	List of domain validations for the order.
.. domain_id	string	Domain ID.
.. name_scope	string	Name scope for the validation.
.. approval_scope	string	Approval scope for the validation.
.. status	string	Validation status.
.. method	string	DCV method used.
.. dns_names	array	Additional SANs to secure.
.. approval_expiration_date	string	Timestamp when domain validation expires. Possible values: `pending`, `active`

Response parameters

About