Subaccount info

4 minute read

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 -X GET \
  'https://www.digicert.com/services/v2/account/subaccount/{{subaccount_id}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

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)

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

}

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

{
  "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

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`.