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

**GET** `https://www.digicert.com/services/v2/account/subaccount`

Use this endpoint to list all subaccounts.

## Example requests and responses

**cURL**

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

**Python**

```python
import requests

url = "https://www.digicert.com/services/v2/account/subaccount"

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

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

print(response.text)
```

**Go**

```go
package main

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

func main() {

	url := "https://www.digicert.com/services/v2/account/subaccount"

	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/account/subaccount',
  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
{
  "subaccounts": [
    {
      "account_id": 112233,
      "account_type": "reseller",
      "organization_name": "Number one organization",
      "date_created": "2018-11-29 01:48:04",
      "account_manager": "Jim James"
    },
    {
      "account_id": 112234,
      "account_type": "enterprise",
      "organization_name": "Number two organization",
      "date_created": "2018-11-29 18:25:04",
      "account_manager": "Jill Valentine"
    },
    {
      "account_id": 112235,
      "account_type": "retail",
      "organization_name": "Number three organization",
      "date_created": "2018-12-04 15:24:43",
      "account_manager": "Rick Roll"
    }
  ],
  "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. 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[account_type]</code>: See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#subaccount-types">Glossary – Subaccount types</a>.</li><li><code>filters[account_id]</code></li><li><code>filters[organization_name]</code></li><li><code>filters[date_created]</code></li></ul></td>
</tr>
<tr>
<td>filters[search]</td>
<td>optional</td>
<td>string</td>
<td>Limits response to results where the value of the <code>organization_name</code> property matches or contains a specific string of characters.<br>To search for values that contain a specific string of characters, prefix the string with a URL encoded (percent-encoded) <strong>%</strong> character: <code>%25</code>. To search for values that are an exact match for a string of characters, omit the <code>%25</code> from the request.<br><strong>Examples:</strong><br><ul><li><code>filters[search]=%25digicert</code> Limits response to results where the value of a searched property contains the string <code>digicert</code></li><li><code>filters[search]=digicert</code> Limits response to results where the value of a searched property is an exact match for the string <code>digicert</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>account_id</code></li><li><code>account_type</code></li><li><code>organization_name</code></li><li><code>date_created</code></li><li><code>account_manager</code></li></ul></td>
</tr>
<tr>
<td>offset</td>
<td>optional</td>
<td>int</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>int</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>child_accounts</td>
<td>array</td>
<td>List of all subaccounts.</td>
</tr>
<tr>
<td>.. account_id</td>
<td>int</td>
<td>Account ID.</td>
</tr>
<tr>
<td>.. account_type</td>
<td>string</td>
<td>Defines the subaccount type. See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#subaccount-types">Glossary – Subaccount types</a>.</td>
</tr>
<tr>
<td>.. organization_name</td>
<td>string</td>
<td>Legal name of the subaccount's primary organization.</td>
</tr>
<tr>
<td>.. date_created</td>
<td>string</td>
<td>Timestamp of when the subaccount was created.<br>Format:
 yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>.. account_manager</td>
<td>string</td>
<td>Name of the subaccount's account representative.</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>Details about results. Modified using URL query strings.</td>
</tr>
</tbody>
</table>