Organization info
4 minute read
GET
Use this endpoint to get details about an organization.https://www.digicert.com/services/v2/organization/{{organization_id}}
Example requests and responses
curl -X GET \
'https://www.digicert.com/services/v2/organization/{{organization_id}}' \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}'import requests
url = "https://www.digicert.com/services/v2/organization/{{organization_id}}"
headers = {
'X-DC-DEVKEY': "{{api_key}}",
'Content-Type': "application/json"
}
response = requests.request("GET", url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://www.digicert.com/services/v2/organization/{{organization_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/organization/{{organization_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);
});{
"id": 112233,
"status": "active",
"name": "Epigyne Unwieldiness llc",
"assumed_name": "Epigyne Unwieldiness",
"display_name": "Epigyne Unwieldiness llc (Epigyne Unwieldiness)",
"is_active": true,
"address": "932 Prospect Street",
"address2": "Floor 08",
"zip": "40849",
"city": "Minneapolis",
"state": "Minnesota",
"country": "us",
"telephone": "666-186-6450",
"container": {
"id": 4,
"parent_id": 0,
"name": "DigiCert Inc.",
"is_active": true
},
"organization_contact": {
"id": 184,
"first_name": "Gia",
"last_name": "Booth",
"email": "gia.booth@inbox.com",
"job_title": "Clinical Laboratory Technician",
"telephone": "666-186-6450",
"telephone_extension": "736"
}
}{
"id": 112236,
"status": "active",
"name": "Palaeontography Enigmatic Corp.",
"assumed_name": "Palaeontography Enigmatic",
"display_name": "Palaeontography Enigmatic Corp. (Palaeontography Enigmatic)",
"is_active": true,
"address": "695 Monroe Drive",
"address2": "Bldg 74",
"zip": "18851",
"city": "Pittsburgh",
"state": "Pennsylvania",
"country": "us",
"telephone": "546-438-8237",
"container": {
"id": 4,
"parent_id": 0,
"name": "DigiCert Inc.",
"is_active": true
},
"organization_contact": {
"id": 12,
"first_name": "Julissa",
"last_name": "Woodard",
"email": "julissa.woodard@mail.com",
"job_title": "Telemarketer",
"telephone": "546-438-8237",
"telephone_extension": "215"
},
"ev_approvers": [
{
"id": 16,
"first_name": "Destinee",
"last_name": "Church"
}
],
"extended_validation": {
"business_category": "Private Organization",
"registration_number": "12345",
"jurisdiction_city": "Lehi",
"jurisdiction_state": "Utah",
"jurisdiction_country": "us",
"incorp_agency": "Real Company Name"
},
"container_id_assignments": [
"8"
]
}Response parameters
| Name | Type | Description |
|---|---|---|
| id | int | Organization ID. |
| status | string | Organization status. Possible values:active, inactive. For more information, see Glossary - Organization status. |
| name | string | Legal name of the organization. |
| assumed_name | string | Public name of the organization. Also called DBA name. |
| display_name | string | Full name of the organization. Constructed using name + assumed_name. |
| is_active | bool | Active status of the organization. |
| address | string | Address of the organization. |
| address2 | string | |
| 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. |
| container | object | Primary container the organization is attached to. |
| .. id | int | Container ID. |
| .. parent_id | string | ID of the container’s parent. |
| .. name | string | Name of the container. |
| .. is_active | bool | Active status of the container. |
| organization_contact | object | Organization contact information. |
| .. id | int | Organization contact ID. |
| .. first_name | string | First name of the organization contact. |
| .. last_name | string | Last name of the organization contact. |
| string | Email address of the organization contact. | |
| .. job_title | string | Job title for the organization contact. |
| .. telephone | string | Telephone number of the organization contact. |
| .. telephone_extension | string | Phone extension for the organization contact. |
| verified_contacts | array of objects | List of verified contacts for the organization. |
| .. id | int | Verified contact ID. Important: The verified contact ID is different from the user ID. When you use an existing CertCentral user as a verified contact, DigiCert uses their information to create a new verified contact with an ID that is separate and unique from the user ID. |
| .. name | string | Verified contact name (first_name + last_name). |
| .. first_name | string | Verified contact first name. |
| .. last_name | string | Verified contact last name. |
| .. job_title | string | Verified contact job title. |
| .. telephone | string | Verified contact telephone number |
| string | Verified contact email address. | |
| .. verified_roles | array of objects | List of objects with details about the contact’s verified roles. These roles determine the types of certificate orders a verified contact can approve. To approve an EV, Code Signing (CS), or EV Code Signing (EV CS) certificate order, the contact must have the matching validation type. Note: Contacts validated to approve EV orders can also approve EV Code Signing orders. For verified contacts validated for either EV or EV CS, the API returns both validation_types: EV and EV_CS. |
| .. .. validation_type | string | Validation type. Possible values: EV, CS, EV_CS |
| .. .. status | string | Status of the verified role. Possible values: pending, valid, expired |
| ev_approvers | array of objects | List of users that can approve EV and code signing orders. The list of users is returned only after the organization is validated. |
| .. id | int | User ID. |
| .. first_name | string | User first name. |
| .. last_name | string | User last name. |
| extended_validation | object | Extended validation information about the organization. |
| container_id_assignments | array | List of containers the organization is assigned to. |
Was this page helpful?
Provide feedback