Unterkonto-Auftragsinfo

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.

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}}'

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)

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))

}

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);
});

200 OK (pending)

{
  "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
}

200 OK (issued)

{
  "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
}

200 OK (sub-subaccount order)

{
  "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
}

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.
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.

Response parameters

Über