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

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

Use this endpoint to get details about the organizations in a subaccount.

## Example requests and responses

**cURL**

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

**Python**

```python
import requests

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

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

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

print(response.text)
```

**Go**

```go
package main

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

func main() {

		url := "https://www.digicert.com/services/v2/account/subaccount/1234567/organization"
		method := "GET"

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

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

		res, err := client.Do(req)
		if err != nil {
				fmt.Println(err)
				return
		}
		defer res.Body.Close()

		body, err := ioutil.ReadAll(res.Body)
		if err != nil {
				fmt.Println(err)
				return
		}
		fmt.Println(string(body))
}
```

**NodeJS**

```javascript
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://www.digicert.com/services/v2/account/subaccount/1234567/organization',
  '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
{
  "organizations": [
    {
      "id": 12345678,
      "status": "active",
      "name": "Example Organization",
      "display_name": "Example Organization",
      "validations": [
        {
          "type": "ev",
          "name": "EV",
          "description": "Extended Organization Validation (EV)",
          "date_created": "2020-10-23T06:41:34+00:00",
          "validated_until": "2021-11-23T07:00:00+00:00",
          "status": "active"
        },
        {
          "type": "ov",
          "name": "OV",
          "description": "Normal Organization Validation",
          "date_created": "2020-10-23T06:40:51+00:00",
          "validated_until": "2021-11-23T07:00:00+00:00",
          "status": "active"
        }
      ]
    },
    …
  ]
}
```

## Path parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>subaccount_id</td>
<td>int</td>
<td>ID of the subaccount to query.</td>
</tr>
</tbody>
</table>

## 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[status]</code>: Use <code>active</code> or <code>inactive</code></li><li><code>filters[validation]</code>: Use <code>pending</code> to include organizations with pending validations, or <code>not_pending</code> to include organizations without pending validations.</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>name</code> property matches or contains a specific string of characters.<br><ul><li>To search for values that <strong>contain</strong> a specific string of characters, prefix the string with a URL encoded (percent-encoded) % character: <code>%25</code></li><li>To search for values that are an <strong>exact match</strong> for a string of characters, omit the <code>%25</code> from the request.</li></ul><br>Examples:<br><ul><li><code>filters[search]=%25example</code> Limits response to results where the value of a searched property contains the string <code>example</code></li><li><code>filters[search]=example.com</code> Limits response to results where the values of a searched property is an exact match for the string <code>example.com</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 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>name</code></li><li><code>is_active</code></li></ul></td>
</tr>
<tr>
<td>limit</td>
<td>optional</td>
<td>int</td>
<td>Total number of results to include in the response.<br>Maximum: 1000 (default)</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>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>organizations</td>
<td>array</td>
<td>List of objects with information about each organization.</td>
</tr>
<tr>
<td>.. id</td>
<td>int</td>
<td>Organization ID.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Organization status.<br>Possible values: active, inactive. For more information, see Glossary – Organization status.</td>
</tr>
<tr>
<td>.. name</td>
<td>string</td>
<td>Organization legal name.</td>
</tr>
<tr>
<td>.. display_name</td>
<td>string</td>
<td>Organization display name.</td>
</tr>
<tr>
<td>.. validations</td>
<td>array</td>
<td>List of objects with details about the validation for the organization.<br>Note: Organizations with no validations do not return a validations array.</td>
</tr>
<tr>
<td>.. .. type</td>
<td>string</td>
<td>Validation type identifier.<br>Possible values: See Glossary – Validation types</td>
</tr>
<tr>
<td>.. .. name</td>
<td>string</td>
<td>Name of the validation type.</td>
</tr>
<tr>
<td>.. .. description</td>
<td>string</td>
<td>Description of the validation type.</td>
</tr>
<tr>
<td>.. .. date_created</td>
<td>string</td>
<td>Date and time the organization was validated.<br>Format: YYYY-MM-DDThh:mm:ssTZD UTC time zone and ISO 8601 date.</td>
</tr>
<tr>
<td>.. .. validated_until</td>
<td>string</td>
<td>Date and time the validation expires.<br>Format: YYYY-MM-DDThh:mm:ssTZD UTC time zone and ISO 8601 date.</td>
</tr>
<tr>
<td>.. .. status</td>
<td>string</td>
<td>Validation status.<br>Possible values: See Glossary – Organization validation statuses.</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>Object with pagination details. Modified using URL query strings.</td>
</tr>
</tbody>
</table>