Skip to main content

Product list

GET https://www.digicert.com/services/v2/product

Use this endpoint to list products available to your account.

Example requests and responses

Example 1. cURL
curl -X GET \
  https://www.digicert.com/services/v2/product \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

Example 2. Python
import requests

url = "https://www.digicert.com/services/v2/product"

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/product"

	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/product',
  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

products

array

List of all available products.

.. group_name

string

Group to which the product belongs. See Glossary – Product identifiers.

.. name_id

string

Product identifier. See Glossary – Product identifiers.

.. name

string

Display name of the product.

.. type

string

Product type. See Glossary – Product types.

.. allowed_container_ids

array of ints

List of containers that can request the specified product.

.. allowed_validity_years

array of ints

List of numbers. Each number is a certificate validity period (in years) the product supports.

.. allowed_order_validity_years

array of ints

List of numbers. Each number is an order validity period (in years) the product supports.

Account administrators can limit the order validity periods that users with specific container and role assignments can request for each product. The Product list endpoint does not return details about these custom limits. For information about custom limits for products in your account, use the Product limits endpoint.

.. signature_hash_types

object

Container for signature hash info.

.. .. allowed_hash_types

array

List of allowed hash types for the product.

.. .. .. id

string

Hash identifier. See Glossary – Hash types.

.. .. .. name

string

Hash name.

.. .. default_hash_type_id

string

Default hash type used for the product.

.. allowed_ca_certs

array

List of objects. Each object includes the name and ID for an issuing intermediate certificate authority (ICA) certificate that can be used with the product.

Note: We only return this parameter for public DV, OV, and EV products if:

  • The product supports ICA selection.

  • ICA selection is enabled for the account.

In the Product list response, the list of allowed_ca_certs includes the name and ID for each ICA that may issue end-entity certificates for a given product. This list includes any ICAs disabled for the product at the container or user role level. To only see IDs for ICAs that users may select when ordering a product, see the list of allowed_intermediates in the Product limits response.

Learn more about ICA certificate chain selection for public TLS certificates.

.. .. id

string

ID of the ICA certificate.

In certificate order requests, this ID is the value of the ca_cert_id request parameter.

.. .. name

string

Name of the ICA certificate.

.. csr_required

bool

Specifies if a CSR is required when requesting the product type.

In this section: