Use this endpoint to get details for a certificate order placed by a subaccount or sub-subaccount.
curl -X GET \
'https://www.digicert.com/services/v2/account/subaccount/order/{{order_id}}' \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}'
import requests
url = "https://www.digicert.com/services/v2/account/subaccount/order/{{order_id}}"
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/account/subaccount/order/{{order_id}}"
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/account/subaccount/order/{{order_id}}',
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);
});
{
"id": 123456,
"certificate": {
"id": 101015,
"common_name": "example.com",
"dns_names": [
"sub.example.com"
],
"organization_units": [
"Sales department"
],
"signature_hash": "sha256"
},
"organization": {
"id": 334455,
"name": "Real Organization, LLC",
"assumed_name": "Real Organization",
"display_name": "Real Organization, LLC (Real Organization)"
},
"subaccount": {
"account_id": 123445,
"account_type": "enterprise",
"organization_name": "Sub account organization"
},
"product": {
"name_id": "ssl_securesite",
"name": "Secure Site SSL",
"type": "ssl_certificate"
},
"order_price": {
"cost": 399,
"currency": "USD"
},
"status": "pending",
"number_of_sans": 1,
"date_created": "2019-06-21T09:06:47+00:00",
"validity_years": 1
}
{
"id": 12345678,
"certificate": {
"id": 34567891,
"thumbprint": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX70C5B",
"serial_number": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXC5F",
"common_name": "example.com",
"dns_names": [
"example.com"
],
"valid_from": "2020-10-14",
"valid_till": "2021-10-18",
"days_remaining": 286,
"signature_hash": "sha256"
},
"organization": {
"id": 123456,
"name": "Example Organization",
"display_name": "Example Organization"
},
"subaccount": {
"account_id": 2345678,
"account_type": "enterprise",
"organization_name": "Example account"
},
"product": {
"name_id": "ssl_basic",
"name": "Basic OV",
"type": "ssl_certificate"
},
"order_price": {
"cost": 358,
"currency": "USD"
},
"status": "issued",
"date_created": "2020-10-14T15:18:50+00:00",
"date_issued": "2020-10-14T15:18:52+00:00",
"is_multi_year_plan": "1",
"order_valid_from": "2020-10-14",
"order_valid_till": "2021-10-19",
"validity_years": 1
}
{
"id": 123456,
"subaccount": {
"account_id": 123445,
"account_type": "enterprise",
"organization_name": "Sub account organization"
},
"product": {
"name_id": "ssl_plus",
"name": "Standard SSL",
"type": "ssl_certificate"
},
"order_price": {
"cost": 198,
"currency": "USD"
},
"status": "pending",
"number_of_sans": 1,
"date_created": "2019-05-07T09:33:08+00:00",
"validity_years": 1
}
Name | Type | Description |
---|---|---|
id | int | Order ID. |
certificate | object |
Details about the certificate ordered. Only returned for orders placed by immediate subaccounts. |
.. id | int | Certificate ID. |
.. thumbprint | string |
Thumbprint of the certificate. Only returned if certificate status is issued .
|
.. serial_number | string |
Serial number of the certificate. Only returned if certificate status is issued .
|
.. common_name | string | Name secured by the certificate. |
.. dns_names | array | List of additional names secured by the certificate. |
.. valid_till | string |
Date when certificate validity ends. Only returned if certificate status is issued .Format: yyyy-MM-dd
|
.. organization_units | array | List of organization units on the certificate. |
.. signature_hash | string | Signing algorithm used by the certificate. |
organization | object |
Details about the organization associated with the order. Only returned for orders placed by immediate subaccounts. |
.. id | int | Organization ID. |
.. name | string | Legal name of the organization. |
.. assumed_name | string |
Public name of the organization. Also called DBA name. |
.. display_name | string |
Full name of the organization. Constructed using name + assumed_name. |
subaccount | object | Details about the subaccount that ordered the certificate. |
.. account_id | int | Subaccount ID. |
.. account_type | string | Subaccount type. |
.. organization_name | string | Primary organization of the subaccount. |
product | object | Details about the ordered product. |
.. name_id | string |
Name ID of the product. See Glossary – Product identifiers |
.. name | string |
Display name of the product. See Glossary – Product identifiers |
.. type | string |
Product type. See Glossary – Product types |
order_price | object | Details about the order price. |
.. cost | int | Total order cost. |
.. currency | string |
Currency unit. Possible values: USD
|
status | string |
Status of the order. See Glossary – Order status |
number_of_sans | int |
Number of domains in the dns_names array.
|
date_created | string |
Order creation date. Format: UTC timezone and ISO 8601 date. YYYY-MM-DDThh:mm:ssTZD
|
date_issued | string |
Date when the certificate was issued. Only returned for issued certificate orders. Format: UTC timezone and ISO 8601 date. YYYY-MM-DDThh:mm:ssTZD
|
is_multi_year_plan | string |
Returns "1" if the order is a Multi-year Plan. Only returned if the order is a Multi-year Plan. |
order_valid_from | string |
Start date of the order validity period. Format: YYYY-MM-DD Only returned for issued certificate orders. |
order_valid_till | string |
Expiration date of the order. Format: YYYY-MM-DD Only returned for issued certificate orders. |
validity_years | int | Number of years the certificate will be valid. |