---
title: "Expiring orders and certificates"
source_url: https://dev.digicert.com/certcentral-apis/services-api/reports/expiring-orders-and-certificates.html
api_method: GET
api_endpoint: "/services/v2/report/order/expiring"
api_url: "https://www.digicert.com/services/v2/report/order/expiring"
---

**GET** `https://www.digicert.com/services/v2/report/order/expiring`

Use this endpoint to get the number of orders and certificates in your account that:

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

```console
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.

<table>
<thead>
<tr>
<th>days_expiring</th>
<th>Days until expiration</th>
</tr>
</thead>
<tbody>
<tr>
<td>90</td>
<td>Between 60 (inclusive) and 90 (inclusive)</td>
</tr>
<tr>
<td>60</td>
<td>Between 30 (inclusive) and 60 (exclusive)</td>
</tr>
<tr>
<td>30</td>
<td>Between now (exclusive) and 30 (exclusive)</td>
</tr>
<tr>
<td>-7</td>
<td>Between now (inclusive) and 7 days ago (inclusive)</td>
</tr>
</tbody>
</table>


> **Info**
>
> The "now" in all categories is the day you submit your API request. For example, if you submit a request on September 3, "now" is September 3. The API returns the number of orders and certificates that:
>
> - Expire 0-30, 30-60, and 60-90 days from September 3.
> - Expired in the last 7 days (August 28 – September 3).


## Example requests and responses

**cURL**

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

**cURL (include_expiring_certs)**

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

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

**200 OK (include_expiring_certs)**

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

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>container_id</td>
<td>optional</td>
<td>number</td>
<td>Limit results to a specific container.</td>
</tr>
<tr>
<td>include_expiring_certs</td>
<td>optional</td>
<td>boolean</td>
<td>If true, results include the expiring certificates count in addition to the expiring orders count. Additionally, in <code>expiring_orders</code> objects, the name of the <code>order_count</code> field becomes <code>count</code>, instead.<br>If false (default), results only include the expiring orders count.</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>expiring_orders</td>
<td>array of objects</td>
<td>List of objects with the number of orders in each <code>days_expiring</code> category.</td>
</tr>
<tr>
<td>.. days_expiring</td>
<td>number</td>
<td>Number of days until expiration.<br>Possible values: See Expiration timeframes.</td>
</tr>
<tr>
<td>.. order_count/count<br><strong>Note:</strong> If <code>include_expiring_certs</code> is true, returns as <code>count</code> instead of <code>order_count</code>.</td>
<td>number</td>
<td>Number of orders expiring in the given timeframe. Does not include orders that have been renewed.</td>
</tr>
<tr>
<td>expiring_certs</td>
<td>array of objects</td>
<td>List of objects with the number of certificates in each <code>days_expiring</code> category. Only returned if <code>include_expiring_certs</code> is true.</td>
</tr>
<tr>
<td>.. days_expiring</td>
<td>number</td>
<td>Number of days until expiration.<br>Possible values: See Expiration timeframes.</td>
</tr>
<tr>
<td>.. count</td>
<td>number</td>
<td>Number of certificates expiring in the given timeframe.</td>
</tr>
</tbody>
</table>