---
title: "Status change list"
source_url: https://dev.digicert.com/certcentral-apis/services-api/orders/status-change-list.html
api_method: GET
api_endpoint: "/services/v2/order/certificate/status-changes"
api_url: "https://www.digicert.com/services/v2/order/certificate/status-changes?minutes=10"
---

**GET** `https://www.digicert.com/services/v2/order/certificate/status-changes?minutes=10`

Use this endpoint to list orders that changed status during the given time frame.

## Usage and limitations

This API operation requires you to specify a time frame using query string parameters. The total time frame cannot exceed seven days (10080 minutes, or 604800 seconds).

To list orders that changed status between now and up to seven days ago, use the `minutes` and `seconds` query parameters. Use these parameters alone, or combine them. For example:

**10 minutes**

```bash
curl -g --request GET 'https://www.digicert.com/services/v2/order/certificate/status-changes?minutes=10' \
--header 'X-DC-DEVKEY: {{api_key}}'
```

**60 seconds**

```bash
curl -g --request GET 'https://www.digicert.com/services/v2/order/certificate/status-changes?seconds=60' \
--header 'X-DC-DEVKEY: {{api_key}}'
```

**1 minute 30 seconds**

```bash
curl -g --request GET 'https://www.digicert.com/services/v2/order/certificate/status-changes?minutes=1&seconds=30' \
--header 'X-DC-DEVKEY: {{api_key}}'
```


To list orders that changed status more than seven days ago, use the `status_last_updated` date range filter (`filters[status_last_updated]`). For example:

## Range: January 1, 2023 to January 7, 2023

```bash
curl -g --request GET 'https://www.digicert.com/services/v2/order/certificate/status-changes?filters[status_last_updated]=2023-01-01...2023-01-07' \
--header 'X-DC-DEVKEY: {{api_key}}'
```


> **Info**
>
> When using the `status_last_updated` filter, the response omits orders that changed status again after the end of the given time frame.


## Example requests and responses

**cURL**

```bash
curl -X GET \
  'https://www.digicert.com/services/v2/order/certificate/status-changes?minutes=10' \
  --header 'Content-Type: application/json' \
  --header 'X-DC-DEVKEY: {{api_key}}'
```

**Python**

```python
import requests

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

querystring = {"minutes":"10"}

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

response = requests.request("GET", url, data=payload, headers=headers, params=querystring)

print(response.text)
```

**Go**

```go
package main

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

func main() {

	url := "https://www.digicert.com/services/v2/order/certificate/status-changes?minutes=10"

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

```javascript
var request = require("request");

var options = { method: 'GET',
  url: 'https://www.digicert.com/services/v2/order/certificate/status-changes',
  qs: { minutes: '10' },
  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**

```json
{
  "orders": [
    {
      "order_id": 265,
      "certificate_id": 112233,
      "status": "issued"
    },
    {
      "order_id": 264,
      "certificate_id": 112232,
      "status": "canceled"
    },
    {
      "order_id": 263,
      "certificate_id": 112231,
      "status": "issued"
    },
    {
      "order_id": 262,
      "certificate_id": 112230,
      "status": "rejected"
    },
    {
      "order_id": 261,
      "certificate_id": 112229,
      "status": "issued"
    },
    {
      "order_id": 260,
      "certificate_id": 112228,
      "status": "issued"
    },
    {
      "order_id": 259,
      "certificate_id": 112227,
      "status": "issued"
    }
  ]
}
```

**200 OK (no orders found)**

```json
{}
```

**400 Bad Request**

```json
{
  "errors": [
    {
      "code": "time_frame_too_long",
      "message": "An error occurred while processing your request."
    }
  ]
}
```


## Filters and URL query parameters

This endpoint supports filters, sorting, and pagination. For general information and examples of the syntax to use when applying filters and sorting results, see [Services API - Filters, sorting, and pagination parameters](https://dev.digicert.com/md/certcentral-apis/services-api.md#filters-sorting-and-pagination-parameters).


> **Important**
>
> You must include at least one URL query string filter in your request.


<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>minutes</td>
<td>optional</td>
<td>int</td>
<td>Limit results to orders that changed status in the last <em>n</em> minutes. Use alone, or combine with <code>seconds</code>. The total time frame (<code>minutes</code> plus <code>seconds</code>) cannot exceed seven days.<br><strong>Max:</strong> <code>10080</code></td>
</tr>
<tr>
<td>seconds</td>
<td>optional</td>
<td>int</td>
<td>Limit results to orders that changed status in the last <em>n</em> seconds. Use alone, or combine with <code>minutes</code>. The total time frame (<code>minutes</code> plus <code>seconds</code>) cannot exceed seven days.<br><strong>Max:</strong> <code>604800</code></td>
</tr>
<tr>
<td>filters[status_last_updated]</td>
<td>optional</td>
<td>string</td>
<td>Limits results to orders that changed status in the given date range. Date format is <code>yyyy-MM-dd</code> or <code>yy-mm-dd+HH:mm:ss</code>. Timezone is MDT. Use an ellipses (<code>...</code>) to separate start and end date.<br>When using the <code>status_last_updated</code> filter, the response omits orders that changed status again after the end of the given time frame.<br><strong>Example:</strong> <code>2019-08-01+00:00:00...2019-08-07+23:59:59</code></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>orders</td>
<td>array</td>
<td>List of orders that changed status in the given time frame.<br>When using the <code>status_last_updated</code> filter, the response omits orders that changed status again after the end of the given time frame.</td>
</tr>
<tr>
<td>.. order_id</td>
<td>int</td>
<td>Order ID.</td>
</tr>
<tr>
<td>.. certificate_id</td>
<td>int</td>
<td>Certificate ID.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Current order status. See Glossary – Order status.</td>
</tr>
</tbody>
</table>