Expiring orders and certificates

• Expire within 0-30, 30-60, and 60-90 days of now.
• Expired within the last 7 days.

By default, this endpoint only returns the expiring orders count. To include the expiring certificates count in the results, append the query parameter include_expiring_certs=true to your request URL. This option is useful when you need to retrieve the total number of expiring certificates in your account, including certificates that expire more than 90 days before the order (for example, if the order is for a Multi-year Plan).

https://www.digicert.com/services/v2/report/order/expiring?include_expiring_certs=true

Expiration timeframes

This endpoint returns the number of orders or certificates expiring in a given timeframe (days_expiring) from the time you submit the request.

Example requests and responses

• cURL
• cURL (include_expiring_certs)

curl -X GET \
  https://www.digicert.com/services/v2/report/order/expiring \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

curl -X GET \
  https://www.digicert.com/services/v2/report/order/expiring?include_expiring_certs=true \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

• 200 OK
• 200 OK (include_expiring_certs)

{
  "expiring_orders": [
    {
      "days_expiring": 90,
      "order_count": 10
    },
    {
      "days_expiring": 60,
      "order_count": 13
    },
    {
      "days_expiring": 30,
      "order_count": 3
    },
    {
      "days_expiring": -7,
      "order_count": 1
    }
  ]
}

{
  "expiring_orders": [
    {
      "days_expiring": 90,
      "count": 10
    },
    {
      "days_expiring": 60,
      "count": 13
    },
    {
      "days_expiring": 30,
      "count": 3
    },
    {
      "days_expiring": -7,
      "count": 1
    }
  ],
  "expiring_certs": [
    {
      "days_expiring": 90,
      "count": 5
    },
    {
      "days_expiring": 60,
      "count": 2
    },
    {
      "days_expiring": 30,
      "count": 1
    },
    {
      "days_expiring": -7,
      "count": 0
    }
  ]
}

URL query strings

Response parameters