---
title: "Subaccount order info"
source_url: https://dev.digicert.com/certcentral-apis/services-api/subaccount/subaccount-order-info.html
api_method: GET
api_endpoint: "/services/v2/account/subaccount/order/{{order_id}}"
api_url: "https://www.digicert.com/services/v2/account/subaccount/order/{{order_id}}"
---

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

**cURL**

```bash
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**

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

**Go**

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

}
```

**NodeJS**

```javascript
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)**

```json
{
  "id": 123456,
  "certificate": {
    "id": 101015,
    "common_name": "example.com",
    "dns_names": [
      "sub.example.com"
    ],
    "signature_hash": "sha256",
    "ca_cert": {
      "id": "A937018B9FAF6CC2",
      "name": "DigiCert Global G2 TLS RSA SHA256 2020 CA1"
    }
  },
  "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 (include_validation_status=true)**

```json
{
  "id": 12345678,
  "certificate": {
    "id": 23456,
    "common_name": "example.com",
    "dns_names": [
      "example.com",
      "subdomain.example.com"
    ],
    "signature_hash": "sha256",
    "ca_cert": {
      "id": "<ca_cert_id>",
      "name": "<ca_cert_name>"
    }
  },
  "organization": {
    "id": 1875789,
    "name": "Example Co.",
    "assumed_name": "Example",
    "display_name": "Example Co. (Example)"
  },
  "subaccount": {
    "account_id": 12345,
    "account_type": "retail",
    "organization_name": "Subaccount Inc."
  },
  "product": {
    "name_id": "ssl_basic",
    "name": "Basic OV",
    "type": "ssl_certificate"
  },
  "status": "pending",
  "date_created": "2023-12-11T22:12:26+00:00",
  "is_multi_year_plan": "1",
  "validity_years": 1,
  "order_price": {
    "cost": <cost>,
    "currency": "USD"
  },
  "subaccount_order_validations": {
    "order_name_scope": "base_domain",
    "order_dcv_method": "dns-txt-token",
    "organization_validations": [
      {
        "type": "ov",
        "name": "OV",
        "description": "Normal Organization Validation",
        "status": "pending",
        "verification_details": {
          "organization_type": "pending",
          "organization_status": "pending",
          "address_verification": "pending",
          "blacklist_fraud": "pending",
          "request_authenticity": "pending"
        }
      }
    ],
    "dns_name_validations": [
      {
        "status": "unapproved",
        "dns_names": [
          "subdomain.example.com"
        ],
        "base_domain": "example.com"
      },
      {
        "status": "unapproved",
        "dns_names": [
          "example.com"
        ],
        "base_domain": "example.com"
      }
    ]
  }
}
```

**200 OK (issued)**

```json
{
  "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",
    "ca_cert": {
      "id": "A937018B9FAF6CC2",
      "name": "DigiCert Global G2 TLS RSA SHA256 2020 CA1"
    }
  },
  "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
  "cs_provisioning_method": "email"
}
```

**200 OK (sub-subaccount order)**

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


## URL query parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>include_validation_status</td>
<td>boolean</td>
<td>If <code>true</code>, the response includes a <code>subaccount_order_validations</code> object with details about the status of domain and organization validations for the order. If <code>false</code> (default), the response omits the <code>subaccount_order_validations</code> object.</td>
</tr>
<tr>
<td>include_cs_provisioning_method</td>
<td>boolean</td>
<td>If <code>true</code>, the response includes a <code>cs_provisioning_method</code> parameter that indicates the provisioning method used for the certificate. See Glossary – CS provisioning methods.<br><strong>Example cURL request</strong><br><code>curl -X GET \
  https://www.digicert.com/services/v2/order/certificate/{{order_id}}?include_cs_provisioning_method=true\
  -H &#x27;Content-Type: application/json&#x27; \
  -H &#x27;X-DC-DEVKEY: {{api_key}}&#x27;},
“status”: “pending”,
“caa_status_message”: {
     “digicert.com”: “CAA check is not called yet”
…
},</code></td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>int</td>
<td>Order ID.</td>
</tr>
<tr>
<td>certificate</td>
<td>object</td>
<td>Details about the certificate ordered. Only returned for orders placed by immediate subaccounts.</td>
</tr>
<tr>
<td>.. id</td>
<td>int</td>
<td>Certificate ID.</td>
</tr>
<tr>
<td>.. thumbprint</td>
<td>string</td>
<td>Thumbprint of the certificate. Only returned if certificate status is issued.</td>
</tr>
<tr>
<td>.. serial_number</td>
<td>string</td>
<td>Serial number of the certificate. Only returned if certificate status is issued.</td>
</tr>
<tr>
<td>.. common_name</td>
<td>string</td>
<td>Name secured by the certificate.</td>
</tr>
<tr>
<td>.. dns_names</td>
<td>array</td>
<td>List of additional names secured by the certificate.</td>
</tr>
<tr>
<td>.. valid_till</td>
<td>string</td>
<td>Date when certificate validity ends. Only returned if certificate status is issued.<br>Format:
yyyy-MM-dd</td>
</tr>
<tr>
<td>.. organization_units</td>
<td>array</td>
<td>List of organization units on the certificate.</td>
</tr>
<tr>
<td>.. signature_hash</td>
<td>string</td>
<td>Signing algorithm used by the certificate.</td>
</tr>
<tr>
<td>.. ca_cert</td>
<td>object</td>
<td>Details about the issuing CA certificate for the primary certificate on the order.</td>
</tr>
<tr>
<td>.. .. id</td>
<td>string</td>
<td>Issuing CA certificate ID.</td>
</tr>
<tr>
<td>.. .. name</td>
<td>string</td>
<td>Issuing CA certificate name.</td>
</tr>
<tr>
<td>organization</td>
<td>object</td>
<td>Details about the organization associated with the order. Only returned for orders placed by immediate subaccounts.</td>
</tr>
<tr>
<td>.. id</td>
<td>int</td>
<td>Organization ID.</td>
</tr>
<tr>
<td>.. name</td>
<td>string</td>
<td>Legal name of the organization.</td>
</tr>
<tr>
<td>.. assumed_name</td>
<td>string</td>
<td>Public name of the organization. Also called DBA name.</td>
</tr>
<tr>
<td>.. display_name</td>
<td>string</td>
<td>Full name of the organization. Constructed using name + assumed_name.</td>
</tr>
<tr>
<td>subaccount</td>
<td>object</td>
<td>Details about the subaccount that ordered the certificate.</td>
</tr>
<tr>
<td>.. account_id</td>
<td>int</td>
<td>Subaccount ID.</td>
</tr>
<tr>
<td>.. account_type</td>
<td>string</td>
<td>Subaccount type.</td>
</tr>
<tr>
<td>.. organization_name</td>
<td>string</td>
<td>Primary organization of the subaccount.</td>
</tr>
<tr>
<td>product</td>
<td>object</td>
<td>Details about the ordered product.</td>
</tr>
<tr>
<td>.. name_id</td>
<td>string</td>
<td>Name ID of the product. See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md">Glossary – Product identifiers</a>.</td>
</tr>
<tr>
<td>.. name</td>
<td>string</td>
<td>Display name of the product. See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md">Glossary – Product identifiers</a></td>
</tr>
<tr>
<td>.. type</td>
<td>string</td>
<td>Product type. See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#section-idm33286470715138">Glossary – Product types</a>.</td>
</tr>
<tr>
<td>order_price</td>
<td>object</td>
<td>Details about the order price.</td>
</tr>
<tr>
<td>.. cost</td>
<td>int</td>
<td>Total order cost.</td>
</tr>
<tr>
<td>.. currency</td>
<td>string</td>
<td>Currency unit.<br>Possible values:
USD</td>
</tr>
<tr>
<td>status</td>
<td>string</td>
<td>Status of the order. See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#order-status">Glossary – Order status</a>.</td>
</tr>
<tr>
<td>number_of_sans</td>
<td>int</td>
<td>Number of domains in the <code>dns_names</code> array.</td>
</tr>
<tr>
<td>date_created</td>
<td>string</td>
<td>Order creation date.<br>Format: UTC timezone and ISO 8601 date. YYYY-MM-DDThh:mm:ssTZD</td>
</tr>
<tr>
<td>date_issued</td>
<td>string</td>
<td>Date when the certificate was issued. Only returned for issued certificate orders.<br>Format: UTC timezone and ISO 8601 date. YYYY-MM-DDThh:mm:ssTZD</td>
</tr>
<tr>
<td>is_multi_year_plan</td>
<td>string</td>
<td>Returns <code>&quot;1&quot;</code> if the order is a Multi-year Plan.<br>Only returned if the order is a Multi-year Plan.</td>
</tr>
<tr>
<td>order_valid_from</td>
<td>string</td>
<td>Start date of the order validity period.<br>Format:YYYY-MM-DD<br>Only returned for issued certificate orders.</td>
</tr>
<tr>
<td>order_valid_till</td>
<td>string</td>
<td>Expiration date of the order.<br>Format: YYYY-MM-DDOnly returned for issued certificate orders.</td>
</tr>
<tr>
<td>validity_years</td>
<td>int</td>
<td>Number of years the certificate will be valid.</td>
</tr>
<tr>
<td>order_prices</td>
<td>array of objects</td>
<td>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 <code>order_prices</code> array. Each item in the <code>order_prices</code> array represents the total cost of reissues requested for the order in the given <code>currency</code>.<br>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 <code>cost</code> value in the <code>order_price</code> object.</td>
</tr>
<tr>
<td>.. cost</td>
<td>number</td>
<td>Total cost of reissues requested in the corresponding <code>currency</code>.</td>
</tr>
<tr>
<td>.. currency</td>
<td>string</td>
<td>Currency unit for the corresponding <code>cost</code> value.</td>
</tr>
<tr>
<td>subaccount_order_validations</td>
<td>object</td>
<td>Object with domain and organization validation details for the order. Only returned if the request URL contains <code>include_validation_status=true</code>.</td>
</tr>
<tr>
<td>.. order_name_scope</td>
<td>string</td>
<td>Domain validation scope for the order. Domain validation scope determines the specific domains that you must validate before DigiCert can issue your certificate.<br><strong>Possible values:</strong><br><ul><li><code>base_domain</code>: Validate each domain and subdomain in the request at the base domain level (such as <em>example.com</em>).</li><li><code>fqdn</code>: Validate each domain and subdomain included in the order exactly as named in the request. When using <code>fqdn</code>: <ul><li>If a domain is a subdomain of another domain included on the order, complete the DCV check for the higher-level domain.</li><li><strong>For OV and EV certificate orders</strong>, if a higher-level domain exists in the account with an active validation, we validate the domain under the scope of the existing domain.</li></ul></li></ul></td>
</tr>
<tr>
<td>.. order_dcv_method</td>
<td>string</td>
<td>Domain control validation (DCV) method for the order.</td>
</tr>
<tr>
<td>.. organization_validations</td>
<td>array of objects</td>
<td>List of objects with details about organization validations that must be complete before DigiCert can issue the certificate.<br><strong>Note:</strong> The <code>organization_validations</code> array is not returned for DV certificate orders.</td>
</tr>
<tr>
<td>.. .. type</td>
<td>string</td>
<td>Validation type ID. See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#validation-types">Glossary – Validation types</a>.</td>
</tr>
<tr>
<td>.. .. name</td>
<td>string</td>
<td>Friendly name of the validation type.</td>
</tr>
<tr>
<td>.. .. description</td>
<td>string</td>
<td>Description of the validation type.</td>
</tr>
<tr>
<td>.. .. date_created</td>
<td>string</td>
<td>Timestamp when validation was completed. UTC timezone and ISO 8601 date.</td>
</tr>
<tr>
<td>.. .. validated_until</td>
<td>string</td>
<td>Timestamp when validation will expire. UTC timezone and ISO 8601 date.</td>
</tr>
<tr>
<td>.. .. status</td>
<td>string</td>
<td>Validation status.<br><strong>Possible values:</strong><code>pending</code>, <code>active</code></td>
</tr>
<tr>
<td>.. .. verified_contacts</td>
<td>array of objects</td>
<td>List of objects with details about verified contacts for the organization.</td>
</tr>
<tr>
<td>.. .. user_id</td>
<td>string</td>
<td>Contact user ID. Returns <code>&quot;0&quot;</code> if the verified contact is not a user in your CertCentral account.</td>
</tr>
<tr>
<td>.. .. name</td>
<td>string</td>
<td>Contact name.</td>
</tr>
<tr>
<td>.. .. first_name</td>
<td>string</td>
<td>Contact first name.</td>
</tr>
<tr>
<td>.. .. last_name</td>
<td>string</td>
<td>Contact last name.</td>
</tr>
<tr>
<td>.. .. job_title</td>
<td>string</td>
<td>Contact job title.</td>
</tr>
<tr>
<td>.. .. telephone</td>
<td>string</td>
<td>Contact telephone number.</td>
</tr>
<tr>
<td>.. .. email</td>
<td>string</td>
<td>Contact email address.</td>
</tr>
<tr>
<td>.. .. status</td>
<td>string</td>
<td>Contact approval status.<br><strong>Possible values:</strong><code>pending</code>, <code>active</code></td>
</tr>
<tr>
<td>.. .. verification_details</td>
<td>object</td>
<td>Object containing the status of each component involved in verifying your certificate request.</td>
</tr>
<tr>
<td>.. .. .. organization_type</td>
<td>string</td>
<td>Status of verification of organization type. Only returned for OV certificate orders.<br><strong>Possible values:</strong><code>pending</code>, <code>complete</code></td>
</tr>
<tr>
<td>.. .. .. organization_status</td>
<td>string</td>
<td>Status of verification that the business is still active. Returned for OV, code signing, and doc signing certificate orders.<br><strong>Possible values:</strong><code>pending</code>, <code>complete</code></td>
</tr>
<tr>
<td>.. .. .. address_verification</td>
<td>string</td>
<td>Status of verification of the legal physical address for the organization. Returned for OV, code signing, and doc signing certificate orders.</td>
</tr>
<tr>
<td>.. .. .. blacklist_fraud</td>
<td>string</td>
<td>Status of verification that the organization doesn’t appear on "do not issue" lists or "bad actor" lists. Returned for EV, OV, doc signing, and VMC certificate orders.<br><strong>Possible values:</strong><code>pending</code>, <code>complete</code></td>
</tr>
<tr>
<td>.. .. .. blacklist_fraud_malware</td>
<td>string</td>
<td>Status of verification that the organization is not a known malware signer. Returned for code signing and EV code signing certificate orders.<br><strong>Possible values:</strong><code>pending</code>, <code>complete</code></td>
</tr>
<tr>
<td>.. .. .. request_authenticity</td>
<td>string</td>
<td>Status of verification that the certificate requestor has authority to order a certificate for the organization. Only returned for OV certificate orders.<br><strong>Possible values:</strong><code>pending</code>, <code>complete</code></td>
</tr>
<tr>
<td>.. .. .. operational_existence</td>
<td>string</td>
<td>Status of verification that the organization exists and is operational. Returned for EV, EV code signing, and VMC certificate orders.<br><strong>Possible values:</strong><code>pending</code>, <code>complete</code></td>
</tr>
<tr>
<td>.. .. .. place_of_business_verification</td>
<td>string</td>
<td>Status of verification of the organization’s place of business. Returned for EV, EV code signing, and VMC certificate orders.<br><strong>Possible values:</strong><code>pending</code>, <code>complete</code></td>
</tr>
<tr>
<td>.. .. .. phone_number_verification</td>
<td>string</td>
<td>Status of verification that the phone number given is valid and tied to the organization. Returned for EV, code signing, EV code signing, and VMC certificate orders.<br><strong>Possible values:</strong><code>pending</code>, <code>complete</code></td>
</tr>
<tr>
<td>.. .. .. approver_verification</td>
<td>string</td>
<td>Status of verification that the approver is valid for this organization. Returned for EV, code signing, EV code signing, and VMC certificate orders.<br><strong>Possible values:</strong><code>pending</code>, <code>complete</code></td>
</tr>
<tr>
<td>.. .. .. approver_blacklist</td>
<td>string</td>
<td>Status of verification that the approver doesn’t appear on "do not issue" or "bad actor" lists. Returned for EV, code signing, EV code signing, and VMC certificate orders.<br><strong>Possible values:</strong><code>pending</code>, <code>complete</code></td>
</tr>
<tr>
<td>.. .. .. logo_trademark</td>
<td>string</td>
<td>Status of verification that the logo is a registered trademark for the organization on the order. Only returned for VMC certificate orders.<br><strong>Possible values:</strong><code>pending</code>, <code>complete</code></td>
</tr>
<tr>
<td>.. dns_name_validations</td>
<td>array of objects</td>
<td>List of objects with validation details for each domain on the order. Returned for EV, OV, DV, and VMC certificate orders.</td>
</tr>
<tr>
<td>.. .. status</td>
<td></td>
<td>Validation status.<br><strong>Possible values:</strong><code>approved</code>, <code>unapproved</code></td>
</tr>
<tr>
<td>.. .. method</td>
<td></td>
<td>DCV method for the domain. Only returned if the validation status for the domain is <code>unapproved</code>.<br><strong>Note:</strong> For OV and EV orders, this parameter is omitted unless the order specifies a domain-level DCV method for the domain. For domains without a <code>method</code>, validate the domain using the DCV method set for the order (<code>order_dcv_method</code>).</td>
</tr>
<tr>
<td>.. .. name_scope</td>
<td></td>
<td>Domain you must validate to prove you control the domain on the order. Only returned if the validation status for the domain is <code>unapproved</code>.<br>The <code>name_scope</code> value is useful when you need to validate a domain on the order by completing a DCV check for either the base domain or for a subdomain between the FQDN and base domain.<br><strong>Note:</strong> For OV and EV orders, this parameter is omitted unless the order specifies a domain-level validation scope for the domain. For domains without a <code>name_scope</code>, validate the domain using the validation scope set for the order (<code>order_name_scope</code>).</td>
</tr>
<tr>
<td>.. .. dns_names</td>
<td></td>
<td>List containing the SAN from the certificate order associated with the validation details in the <code>dns_name_validations</code> object.</td>
</tr>
<tr>
<td>.. base_domain</td>
<td></td>
<td>Base domain of the hostname in the <code>dns_names</code> array.</td>
</tr>
<tr>
<td>cs_provisioning_method</td>
<td>string</td>
<td>Returns the provisioning method for the certificate. See Glossary – CS provisioning methods.</td>
</tr>
</tbody>
</table>