---
title: "List unit orders"
source_url: https://dev.digicert.com/certcentral-apis/services-api/subaccount/list-unit-orders.html
api_method: GET
api_endpoint: "/services/v2/units/order"
api_url: "https://www.digicert.com/services/v2/units/order"
---

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

Use this endpoint to get a list of unit orders.

## Example requests and responses

**cURL**

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

**Python**

```python
import requests

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

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

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

print(response.text.encode('utf8'))
```

**Go**

```go
package main

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

func main() {

		url := "https://www.digicert.com/services/v2/units/order"
		method := "GET"

		client := &http.Client {
		}
		req, err := http.NewRequest(method, url, nil)

		if err != nil {
				fmt.Println(err)
		}
		req.Header.Add("X-DC-DEVKEY", {{api_key}})
		req.Header.Add("Content-Type", "application/json")

		res, err := client.Do(req)
		defer res.Body.Close()
		body, err := ioutil.ReadAll(res.Body)

		fmt.Println(string(body))
}
```

**NodeJS**

```javascript
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://www.digicert.com/services/v2/units/order',
  'headers': {
    'X-DC-DEVKEY': {{api_key}},
    'Content-Type': 'application/json'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
```


## 200 OK

```json
{
  "orders": [
    {
      "id": 1003,
      "unit_account_id": 1234567,
      "unit_account_name": "Example Subaccount",
      "cost": 10,
      "currency": "USD",
      "status": "completed",
      "expiration_date": "2021-11-02",
      "created_date": "2020-11-02 13:19:47"
    },
    {
      "id": 1007,
      "unit_account_id": 1234567,
      "unit_account_name": "Example Subaccount",
      "cost": 3,
      "currency": "USD",
      "status": "completed",
      "expiration_date": "2021-11-02",
      "created_date": "2020-11-02 13:24:16"
    },
    {
      "id": 1011,
      "unit_account_id": 1234567,
      "unit_account_name": "Example Subaccount",
      "cost": 15,
      "currency": "USD",
      "status": "completed",
      "expiration_date": "2021-11-03",
      "created_date": "2020-11-03 02:13:58"
    }
  ],
  "page": {
    "total": 3,
    "limit": 1000,
    "offset": 0
  }
}
```

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

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>filters[<code>{{property_name}}</code>]</td>
<td>optional</td>
<td>string</td>
<td>Filters results by the specified property.<br>Replace <code>{{property_name}}</code> in your request with the property to use for filtering. This endpoint supports filtering by the following properties:<br><ul><li><code>filters[unit_account_id]</code></li><li><code>filters[status]</code></li></ul></td>
</tr>
<tr>
<td>sort</td>
<td>optional</td>
<td>string</td>
<td>Sorts results by the value of one or more properties.<br>By default, sorts results in ascending alphabetical order (0-9, A-Z). To sort in descending alphabetical order (9-0, Z-A), prefix the property name with a minus (<code>-</code>).<br>To sort by multiple properties, separate the name of each property with a comma. Sort hierarchy matches the order of properties in this list.<br>This endpoint supports sorting by the following properties:<br><ul><li><code>id</code></li><li><code>unit_account_id</code></li><li><code>unit_account_name</code></li><li><code>cost</code></li><li><code>status</code></li><li><code>expiration_date</code></li><li><code>created_date</code></li></ul></td>
</tr>
<tr>
<td>offset</td>
<td>optional</td>
<td>integer</td>
<td>Index of the first result to include in the response.<br>Default:
 0</td>
</tr>
<tr>
<td>limit</td>
<td>optional</td>
<td>integer</td>
<td>Total number of results to include in the response.<br>Max: 1000 (default)</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 objects with details for each unit order.</td>
</tr>
<tr>
<td>.. id</td>
<td>integer</td>
<td>ID of the order.</td>
</tr>
<tr>
<td>.. unit_account_id</td>
<td>integer</td>
<td>Account ID of the subaccount on the order.</td>
</tr>
<tr>
<td>.. unit_account_name</td>
<td>string</td>
<td>Name of the subaccount on the order.</td>
</tr>
<tr>
<td>.. cost</td>
<td>double</td>
<td>Total order cost.</td>
</tr>
<tr>
<td>.. currency</td>
<td>string</td>
<td>Currency unit for order cost.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Order status.<br>Possible values: completed, canceled</td>
</tr>
<tr>
<td>.. expiration_date</td>
<td>string</td>
<td>Expiration date of the units.<br>Format:
 YYYY-MM-DD</td>
</tr>
<tr>
<td>.. created_date</td>
<td>string</td>
<td>Creation timestamp for the order.<br>Format:
 YYYY-MM-DD hh:mm:ss</td>
</tr>
<tr>
<td><a href="https://dev.digicert.com/md/certcentral-apis/services-api/structures.md#page-details-object">page</a></td>
<td>object</td>
<td>Pagination details for the results. Modified using URL query strings.</td>
</tr>
</tbody>
</table>