List orders

GET
https://www.digicert.com/services/v2/order/certificate

Use this endpoint to list all certificate orders.

Change the ACCEPT header to text/csv to return a CSV output of the results.

cURL
curl -X GET \
  https://www.digicert.com/services/v2/order/certificate \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
Python
import requests

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

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

response = requests.request("GET", url, headers=headers)

print(response.text)
Go
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

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

	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/order/certificate',
  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
{
  "orders": [
    {
      "id": 123456,
      "certificate": {
        "id": 104,
        "common_name": "example.com",
        "dns_names": [
          "example2.com",
          "example3.com"
        ],
        "signature_hash": "sha256"
      },
      "status": "pending",
      "is_renewed": false,
      "date_created": "2018-10-16T17:29:56+00:00",
      "organization": {
        "id": 112233,
        "name": "Epigyne Unwieldiness llc"
      },
      "validity_years": 1,
      "disable_renewal_notifications": false,
      "container": {
        "id": 14,
        "name": "DigiCert Inc."
      },
      "product": {
        "name_id": "ssl_plus",
        "name": "Standard SSL",
        "type": "ssl_certificate"
      },
      "has_duplicates": false,
      "product_name_id": "ssl_plus"
    },
    {
      "id": 123457,
      "certificate": {
        "id": 105,
        "common_name": "example.org",
        "dns_names": [
          "sub.example.org"
        ],
        "valid_till": "2020-04-30",
        "days_remaining": 289,
        "signature_hash": "sha256"
      },
      "status": "issued",
      "is_renewed": false,
      "date_created": "2019-04-30T18:02:50+00:00",
      "organization": [],
      "validity_years": 1,
      "container": {
        "id": 14,
        "name": "CertCentral"
      },
      "product": {
        "name_id": "ssl_dv_geotrust",
        "name": "GeoTrust Standard DV",
        "type": "dv_ssl_certificate"
      },
      "has_duplicates": false,
      "product_name_id": "ssl_dv_geotrust"
    },
    ...
  ],
  "page": {
    "total": 31,
    "limit": 0,
    "offset": 0
  }
}

URL query strings

Name Type Description
offset optional int
limit optional int

Response parameters

Name Type Description
orders array List of orders returned by the request.
.. id int Order ID.
.. certificate object Details about the certificate ordered.
.. .. id int Certificate ID.
.. .. common_name string Name secured by the certificate.
.. .. dns_names array List of additional names secured by the certificate.
.. .. valid_till string Expiration date of the certificate.
Format: yyyy-MM-dd
.. .. days_remaining int Number of days until certificate expires.
.. .. signature_hash string Signing algorithm used by the certificate.
.. status string Status of the order.
See Glossary – Order status
.. is_renewed bool Specifies if the order has been renewed.
.. date_created string Order creation date.
Format: UTC timezone and ISO 8601 date
.. organization object Details about the organization associated with the order.
.. .. id int Organization ID.
.. .. name string Legal name of the organization.
.. validity_years int Number of years the certificate will be valid.
.. disable_renewal_notifications bool Specifies if renewal notifications are enabled.
.. container object Details about the container associated with the order.
.. .. id int Container ID.
.. .. name string Name of the container.
.. 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
.. has_duplicates bool Specifies if there are duplicates.
.. product_name_id string Name ID of the product.
See Glossary – Product identifiers
page object Details about results.
Modified using URL query strings.