Skip to main content

Subaccount order info

GET https://www.digicert.com/services/v2/account/subaccount/order/{{order_id}}

Use this endpoint to get details for a certificate order placed by a subaccount or sub-subaccount.

Example requests and responses

Example 1. cURL
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}}'

Example 2. Python
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)

Example 3. Go
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))

}

Example 4. NodeJS
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);
});

Response parameters

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.

.. ca_cert

object

Details about the issuing CA certificate for the primary certificate on the order.

.. .. id

string

Issuing CA certificate ID.

.. .. name

string

Issuing CA certificate name.

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-DDOnly returned for issued certificate orders.

validity_years

int

Number of years the certificate will be valid.

order_prices

array of objects

If the subaccount reissues a certificate on the order and the parent account is using a different currency than when the original order was placed, this endpoint returns an order_prices array. Each item in the order_prices array represents the total cost of reissues requested for the order in the given currency.

When the subaccount reissues a certificate and the parent account is using the same currency as the when the original order was placed, the extra cost of the reissued certificate is added to the cost value in the order_price object.

.. cost

number

Total cost of reissues requested in the corresponding currency.

.. currency

string

Currency unit for the corresponding cost value.

In this section: