Validation details

GET https://www.digicert.com/services/v2/organization/{{organization_id}}/validation

Use this endpoint to get validation details for an organization.

Example requests and responses

Example 1. cURL

curl -X GET \
  'https://www.digicert.com/services/v2/organization/{{organization_id}}/validation' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

Example 2. Python

import requests

url = "https://www.digicert.com/services/v2/organization/{{organization_id}}/validation"

headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("GET", url, 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/organization/{{organization_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))

}

Example 4. NodeJS

var request = require("request");

var options = { method: 'GET',
  url: 'https://www.digicert.com/services/v2/organization/{{organization_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);
});

Example 5. 200 OK

{
  "validations": [
    {
      "type": "ov",
      "name": "OV",
      "description": "Normal Organization Validation",
      "date_created": "2018-10-09T19:29:02+00:00",
      "validated_until": "2019-11-09T20:28:55+00:00",
      "status": "active"
    },
    {
      "type": "ev",
      "name": "EV",
      "description": "Extended Organization Validation (EV)",
      "status": "pending",
      "verified_users": [
        {
          "id": 12,
          "first_name": "John",
          "last_name": "Smith"
        },
        {
          "id": 9,
          "first_name": "Destinee",
          "last_name": "Church"
        }
      ]
    }
  ]
}

Response parameters

Name	Type	Description
validations	array	List of approved validation types for the organization.
.. type	string	Validation type identifier. See Glossary – Validation types.
.. name	string	Name of the validation type.
.. description	string	Description of the validation type.
.. date_created	string	Timestamp of when the organization was validated. Format: UTC timezone and ISO 8601 date
.. validated_until	string	Timestamp of when the validation status will expire. Format: UTC timezone and ISO 8601 date
.. status	string	Status of the validation. Possible values: See Glossary – Organization validation statuses.
.. verified_users	array	List of users that have been verified for the particular validation type.
.. .. id	int	User ID.
.. .. first_name	string	First name of user.
.. .. last_name	string	Last name of user.

In this section: