Skip to main content

Subaccount info

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

Use this endpoint to get information about a subaccount.

Example requests and responses

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

Example 2. 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)

Example 3. 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))

}

Example 4. NodeJS
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);
});

Response parameters

Name

Type

Description

account_id

integer

Subaccount ID.

account_type

string

Defines the subaccount type. See Glossary – Subaccount types.

organization_name

string

Legal name of the subaccount's primary organization.

child_name

string

Friendly name to help identify subaccounts with identical or similar names. Only returned if the subaccount has a child_name.

date_created

string

Timestamp of when the subaccount was created.

Format: YYYY-MM-DD hh:mm:ss

parent_account_id

string

Account ID of the subaccount's parent.

billing_account_name

string

Name of the parent account used for billing.

billing_account_id

integer

Account ID of the parent account used for billing.

account_manager

string

Name of the subaccount's account representative.

bill_parent

boolean

If true, DigiCert bills the parent account for orders from the subaccount. If false, DigiCert bills the subaccount directly.

enforce_bill_parent

boolean

If true, the subaccount can only create bill-to-parent child accounts. If false or not returned, the subaccount can create subaccounts with either billing configuration: bill self or bill-to-parent.

master_user

object

Details about the subaccount administrator.

.. first_name

string

First name of the subaccount administrator.

.. last_name

string

Last name of the subaccount administrator.

.. email

string

Email address of the subaccount administrator.

.. job_title

string

Job title of the subaccount administrator.

.. telephone

string

Telephone number of the subaccount administrator.

.. i18n_language_id

string

Preferred language for the subaccount administrator.

.. container_id

string

Container ID the subaccount administrator is assigned to.

organization

object

Details about the subaccount's primary organization.

.. id

integer

Organization ID.

.. status

string

Organization status.

Possible values: active, inactive

.. name

string

Legal name of the organization.

.. address

string

Address of the organization.

.. zip

string

Postal code of the organization.

.. city

string

City where the organization is located.

.. state

string

State where the organization is located.

.. country

string

Country where the organization is located.

.. telephone

string

Organization telephone number.

.. is_active

boolean

Active status of the organization.

.. container

object

Primary container the organization is attached to.

.. .. id

integer

Container ID.

.. .. parent_id

integer

ID of the container's parent.

.. .. name

string

Name of the container.

.. .. is_active

boolean

Active status of the container.

billing_contact

object

Details about the subaccount's billing contact.

.. name

string

Name of the billing contact.

.. address

string

Address of the billing contact.

.. city

string

City of the billing contact.

.. state

string

State of the billing contact.

.. zip

string

Postal code of the billing contact.

.. country

string

Country of the billing contact.

.. email

string

Email address of the billing contact.

.. phone

string

Telephone number of the billing contact.

max_allowed_multi_year_plan_length

integer

Maximum Multi-year Plan length (in years) for orders the subaccount creates.

allow_parent_order_renewal

boolean

If true, subaccount can renew orders created by the parent account. Otherwise, false.

In this section: