Use this endpoint to submit an organization to be validated for the specified validation types.
To get a list of possible user IDs to use for the verified_users
array, use the List approvers endpoint.
curl -X POST \
'https://www.digicert.com/services/v2/organization/{{organization_id}}/validation' \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}' \
-d '{
"validations": [
{
"type": "ov"
},
{
"type": "ev",
"verified_users": [
{
"id": 112233
},
{
"first_name": "Jill",
"last_name": "Valentine",
"job_title": "CTO",
"telephone": "555-555-5555",
"email": "jill.valentine@digicert.com"
}
]
}
]
}'
import requests
url = "https://www.digicert.com/services/v2/organization/{{organization_id}}/validation"
payload = "{\n \"validations\": [\n {\n \"type\": \"ov\"\n },\n {\n \"type\": \"ev\",\n \"verified_users\": [\n {\n \"id\": 112233\n },\n {\n \"first_name\": \"Jill\",\n \"last_name\": \"Valentine\",\n \"job_title\": \"CTO\",\n \"telephone\": \"555-555-5555\",\n \"email\": \"jill.valentine@digicert.com\"\n }\n ]\n }\n ]\n}"
headers = {
'X-DC-DEVKEY': "{{api_key}}",
'Content-Type': "application/json"
}
response = requests.request("POST", url, data=payload, headers=headers)
print(response.text)
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://www.digicert.com/services/v2/organization/{{organization_id}}/validation"
payload := strings.NewReader("{\n \"validations\": [\n {\n \"type\": \"ov\"\n },\n {\n \"type\": \"ev\",\n \"verified_users\": [\n {\n \"id\": 112233\n },\n {\n \"first_name\": \"Jill\",\n \"last_name\": \"Valentine\",\n \"job_title\": \"CTO\",\n \"telephone\": \"555-555-5555\",\n \"email\": \"jill.valentine@digicert.com\"\n }\n ]\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
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: 'POST',
url: 'https://www.digicert.com/services/v2/organization/{{organization_id}}/validation',
headers:
{ 'Content-Type': 'application/json',
'X-DC-DEVKEY': '{{api_key}}' },
body:
{ validations:
[ { type: 'ov' },
{ type: 'ev',
verified_users:
[ { id: 112233 },
{ first_name: 'Jill',
last_name: 'Valentine',
job_title: 'CTO',
telephone: '555-555-5555',
email: 'jill.valentine@digicert.com' } ] } ] },
json: true };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
// empty
When adding an existing contact, use the id
parameter in the request body and omit the first_name
, last_name
, job_title
, telephone
, and email
parameters.
Name | Req/Opt | Type | Description |
---|---|---|---|
validations | required | array | List of validation types the organization will be validated for. |
.. type | required | string |
The validation type identifier. See Glossary – Validation types |
.. verified_users | required | array |
List of verified EV approvers for the organization. Optional for ov and dv validation types.
|
.. .. id | required* | int |
ID of the user to add as the EV approver. *Only required if adding an existing contact. If included, other contact parameters are ignored. |
.. .. first_name | optional* | string |
First name of the verified contact. *Required if the id parameter is omitted.
|
.. .. last_name | optional* | string |
Last name of the verified contact. *Required if the id parameter is omitted.
|
.. .. job_title | optional* | string |
Job title of the verified contact. *Required if the id parameter is omitted.
|
.. .. telephone | optional* | string |
Telephone number of the verified contact. *Required if the id parameter is omitted.
|
optional* | string |
Email address of the verified contact. *Required if the id parameter is omitted.
|