Validation types

  2 minute read  

GET https://www.digicert.com/services/v2/organization/validation-type
Use this endpoint to list validation types for organizations.

Example requests and responses

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

url = "https://www.digicert.com/services/v2/organization/validation-type"

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

response = requests.request("GET", url, headers=headers)

print(response.text)
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/organization/validation-type"

	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/organization/validation-type',
  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

{
  "validation_types": [
    {
      "type": "smime",
      "name": "SMIME",
      "description": "SMIME Organization Validation",
      "requires_user": false
    },
    {
      "type": "cs",
      "name": "CS",
      "description": "Code Signing Organization Validation",
      "requires_user": true
    },
    {
      "type": "ev_cs",
      "name": "EV CS",
      "description": "Code Signing Organization Extended Validation (EV CS)",
      "requires_user": true
    },
    {
      "type": "ds",
      "name": "DS",
      "description": "Document Signing Validation",
      "requires_user": false
    },
    {
      "type": "ov",
      "name": "OV",
      "description": "Normal Organization Validation",
      "requires_user": false,
      "requires_dcv": true
    },
    {
      "type": "ev",
      "name": "EV",
      "description": "Extended Organization Validation (EV)",
      "requires_user": true,
      "requires_dcv": true
    }
  ]
}

Response parameters

NameTypeDescription
validation_typesarray of objectsList of available validation types. See Structures – Validation types object.
Note: The API only returns a validation type if it is required for a product in the account.