---
title: "Subaccount info"
source_url: https://dev.digicert.com/certcentral-apis/services-api/subaccount/subaccount-info.html
api_method: GET
api_endpoint: "/services/v2/account/subaccount/{{subaccount_id}}"
api_url: "https://www.digicert.com/services/v2/account/subaccount/{{subaccount_id}}"
---

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

Use this endpoint to get information about a subaccount.

## Example requests and responses

**cURL**

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

**Python**

```python
import requests

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

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/{{subaccount_id}}"

	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/{{subaccount_id}}',
  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
{
  "account_id": 1122339,
  "account_type": "reseller",
  "organization_name": "Real Organization",
  "date_created": "2018-11-29 18:25:04",
  "parent_account_id": "1122331",
  "billing_account_name": "Billing Account, Inc.",
  "billing_account_id": 1122328,
  "account_manager": "Jim James",
  "bill_parent": false,
  "master_user": {
    "first_name": "Alan",
    "last_name": "Allen",
    "email": "alan.allen@example.com",
    "job_title": "subreseller",
    "telephone": "801-701-9600",
    "i18n_language_id": "1",
    "container_id": "11223"
  },
  "organization": {
    "id": 121212,
    "status": "active",
    "name": "Real Organization",
    "address": "123 Fake Street",
    "zip": "84043",
    "city": "Lehi",
    "state": "Utah",
    "country": "us",
    "telephone": "801-701-9600",
    "is_active": true,
    "container": {
      "id": 11223,
      "parent_id": 0,
      "name": "Real Organization",
      "is_active": true
    }
  },
  "billing_contact": {
    "name": "Alan Allen",
    "address": "123 Fake Street",
    "city": "Lehi",
    "state": "ut",
    "zip": "84043",
    "country": "us",
    "email": "alan.allen@example.com",
    "phone": "801-701-9600"
  },
  "allow_parent_order_renewal": false
}
```

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>account_id</td>
<td>integer</td>
<td>Subaccount 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>child_name</td>
<td>string</td>
<td>Friendly name to help identify subaccounts with identical or similar names. Only returned if the subaccount has a child_name.</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>parent_account_id</td>
<td>string</td>
<td>Account ID of the subaccount's parent.</td>
</tr>
<tr>
<td>billing_account_name</td>
<td>string</td>
<td>Name of the parent account used for billing.</td>
</tr>
<tr>
<td>billing_account_id</td>
<td>integer</td>
<td>Account ID of the parent account used for billing.</td>
</tr>
<tr>
<td>account_manager</td>
<td>string</td>
<td>Name of the subaccount's account representative.</td>
</tr>
<tr>
<td>bill_parent</td>
<td>boolean</td>
<td>If <code>true</code>, DigiCert bills the parent account for orders from the subaccount. If <code>false</code>, DigiCert bills the subaccount directly.</td>
</tr>
<tr>
<td>enforce_bill_parent</td>
<td>boolean</td>
<td>If <code>true</code>, the subaccount can only create <em>bill-to-parent</em> child accounts. If <code>false</code> or not returned, the subaccount can create subaccounts with either billing configuration: <em>bill self</em> or <em>bill-to-parent</em>.</td>
</tr>
<tr>
<td>master_user</td>
<td>object</td>
<td>Details about the subaccount administrator.</td>
</tr>
<tr>
<td>.. first_name</td>
<td>string</td>
<td>First name of the subaccount administrator.</td>
</tr>
<tr>
<td>.. last_name</td>
<td>string</td>
<td>Last name of the subaccount administrator.</td>
</tr>
<tr>
<td>.. email</td>
<td>string</td>
<td>Email address of the subaccount administrator.</td>
</tr>
<tr>
<td>.. job_title</td>
<td>string</td>
<td>Job title of the subaccount administrator.</td>
</tr>
<tr>
<td>.. telephone</td>
<td>string</td>
<td>Telephone number of the subaccount administrator.</td>
</tr>
<tr>
<td>.. i18n_language_id</td>
<td>string</td>
<td>Preferred language for the subaccount administrator.</td>
</tr>
<tr>
<td>.. container_id</td>
<td>string</td>
<td>Container ID the subaccount administrator is assigned to.</td>
</tr>
<tr>
<td>organization</td>
<td>object</td>
<td>Details about the subaccount's primary organization.</td>
</tr>
<tr>
<td>.. id</td>
<td>integer</td>
<td>Organization ID.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Organization status.<br>Possible values: active, inactive</td>
</tr>
<tr>
<td>.. name</td>
<td>string</td>
<td>Legal name of the organization.</td>
</tr>
<tr>
<td>.. address</td>
<td>string</td>
<td>Address of the organization.</td>
</tr>
<tr>
<td>.. zip</td>
<td>string</td>
<td>Postal code of the organization.</td>
</tr>
<tr>
<td>.. city</td>
<td>string</td>
<td>City where the organization is located.</td>
</tr>
<tr>
<td>.. state</td>
<td>string</td>
<td>State where the organization is located.</td>
</tr>
<tr>
<td>.. country</td>
<td>string</td>
<td>Country where the organization is located.</td>
</tr>
<tr>
<td>.. telephone</td>
<td>string</td>
<td>Organization telephone number.</td>
</tr>
<tr>
<td>.. is_active</td>
<td>boolean</td>
<td>Active status of the organization.</td>
</tr>
<tr>
<td>.. container</td>
<td>object</td>
<td>Primary container the organization is attached to.</td>
</tr>
<tr>
<td>.. .. id</td>
<td>integer</td>
<td>Container ID.</td>
</tr>
<tr>
<td>.. .. parent_id</td>
<td>integer</td>
<td>ID of the container's parent.</td>
</tr>
<tr>
<td>.. .. name</td>
<td>string</td>
<td>Name of the container.</td>
</tr>
<tr>
<td>.. .. is_active</td>
<td>boolean</td>
<td>Active status of the container.</td>
</tr>
<tr>
<td>billing_contact</td>
<td>object</td>
<td>Details about the subaccount's billing contact.</td>
</tr>
<tr>
<td>.. name</td>
<td>string</td>
<td>Name of the billing contact.</td>
</tr>
<tr>
<td>.. address</td>
<td>string</td>
<td>Address of the billing contact.</td>
</tr>
<tr>
<td>.. city</td>
<td>string</td>
<td>City of the billing contact.</td>
</tr>
<tr>
<td>.. state</td>
<td>string</td>
<td>State of the billing contact.</td>
</tr>
<tr>
<td>.. zip</td>
<td>string</td>
<td>Postal code of the billing contact.</td>
</tr>
<tr>
<td>.. country</td>
<td>string</td>
<td>Country of the billing contact.</td>
</tr>
<tr>
<td>.. email</td>
<td>string</td>
<td>Email address of the billing contact.</td>
</tr>
<tr>
<td>.. phone</td>
<td>string</td>
<td>Telephone number of the billing contact.</td>
</tr>
<tr>
<td>max_allowed_multi_year_plan_length</td>
<td>integer</td>
<td>Maximum Multi-year Plan length (in years) for orders the subaccount creates.</td>
</tr>
<tr>
<td>allow_parent_order_renewal</td>
<td>boolean</td>
<td>If <code>true</code>, subaccount can renew orders created by the parent account. Otherwise, <code>false</code>.</td>
</tr>
</tbody>
</table>