List subaccount products

GET https://www.digicert.com/services/v2/account/subaccount/{{subaccount_id}}/products

Use this endpoint to list detailed product information for a subaccount.

Tip

To set product limits for a subaccount, use Set subaccount product.

Example requests and responses

Example 1. cURL

curl -X GET \
  'https://www.digicert.com/services/v2/account/subaccount/{{subaccount_id}}/products' \
  -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/{{subaccount_id}}/products"

payload = ""
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("GET", url, data=payload, 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/{{subaccount_id}}/products"

	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/{{subaccount_id}}/products',
  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);
});

Example 5. 200 OK

{
    "currency": "USD",
    "pricing_method": "custom",
    "balance_negative_limit": "222",
    "products": [
        {
            "product_name_id": "ssl_plus",
            "product_name": "Standard SSL",
            "prices": [
                {
                    "lifetime": 1,
                    "cost": 218,
                    "additional_fqdn_cost": 0,
                    "additional_wildcard_cost": 0
                },
                {
                    "lifetime": 2,
                    "cost": 414,
                    "additional_fqdn_cost": 0,
                    "additional_wildcard_cost": 0
                }
            ]
        },
        {
            "product_name_id": "ssl_multi_domain",
            "product_name": "Multi-Domain SSL",
            "prices": [
                {
                    "lifetime": 1,
                    "cost": 412,
                    "additional_fqdn_cost": 135,
                    "additional_wildcard_cost": 0
                },
                {
                    "lifetime": 2,
                    "cost": 782,
                    "additional_fqdn_cost": 257,
                    "additional_wildcard_cost": 0
                }
            ]
        },
        {
            "product_name_id": "ssl_wildcard",
            "product_name": "WildCard",
            "prices": [
                {
                    "lifetime": 1,
                    "cost": 688,
                    "additional_fqdn_cost": 0,
                    "additional_wildcard_cost": 658
                },
                {
                    "lifetime": 2,
                    "cost": 1307,
                    "additional_fqdn_cost": 0,
                    "additional_wildcard_cost": 1250
                }
            ]
        },
        {
            "product_name_id": "ssl_ev_plus",
            "product_name": "EV SSL",
            "prices": [
                {
                    "lifetime": 1,
                    "cost": 344,
                    "additional_fqdn_cost": 0,
                    "additional_wildcard_cost": 0
                },
                {
                    "lifetime": 2,
                    "cost": 654,
                    "additional_fqdn_cost": 0,
                    "additional_wildcard_cost": 0
                }
            ]
        }
    ]
}

Example 6. 200 OK (pricing_method = units)

{
  "pricing_method": "units",
  "products": [
    {
      "product_name_id": "ssl_ev_geotrust_truebizid",
      "product_name": "GeoTrust TrueBusiness ID EV"
    },
    {
      "product_name_id": "ssl_ev_securesite_flex",
      "product_name": "Secure Site EV",
      "unit": {
        "limit": 5,
        "balance": 5
      }
    },
    {
      "product_name_id": "ssl_ev_securesite_pro",
      "product_name": "Secure Site Pro EV SSL",
      "unit": {
        "limit": 5,
        "balance": 5
      }
    },
    {
      "product_name_id": "ssl_geotrust_truebizid",
      "product_name": "GeoTrust TrueBusiness ID OV"
    },
    {
      "product_name_id": "ssl_securesite_flex",
      "product_name": "Secure Site OV",
      "unit": {
        "limit": 5,
        "balance": 5
      }
    },
    {
      "product_name_id": "ssl_securesite_pro",
      "product_name": "Secure Site Pro SSL",
      "unit": {
        "limit": 5,
        "balance": 5
      }
    }
  ]
}

Response parameters

Name	Type	Description
currency	string	Currency code used to display pricing to subaccount. Possible values: See Glossary – Subaccount display currencies.
pricing_method	string	Pricing method used by the subaccount Possible values: `default`, `custom`, `units`
balance_negative_limit	int	Dollar amount that the account balance can go into the negative.
products	array of objects	List of products enabled for the subaccount.
.. product_name_id	string	Product name ID. See Glossary – Product identifiers.
.. product_name	string	Display name of the product.
.. product_shim_map	array of objects	If the product has legacy products shimmed to it, the product object returns a `product_shim_map` array. This array is a list of objects with the `product_name_id` and `product_name` for each legacy product shimmed to the returned product.
.. .. product_name_id	string	Product name ID of the legacy product that is shimmed to the returned product.
.. .. product_name	string	Name of the legacy product that is shimmed to the returned product.
.. prices	array of objects	List of prices for the product. Only returns if the subaccount contains units.
.. .. lifetime	int	Validity term in years that the pricing applies to.
.. .. cost	int	Base price of the product.
.. .. additional_fqdn_cost	int	Cost for each additional domain name (SAN) added to the order.
.. .. additional_wildcard_cost	int	Cost for each additional wildcard domain (e.g., *.example.com) added to the order.
.. unit	object	List of unit details.
.. .. limit	int	Number of units authorized for account.
.. .. balance	int	Number of units available.

In this section: