Organization info

GET https://www.digicert.com/services/v2/organization/{{organization_id}}
Use this endpoint to get details about an organization.

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

NameTypeDescription
idintOrganization ID.
statusstringOrganization status.
Possible values:active, inactive. For more information, see Glossary - Organization status.
namestringLegal name of the organization.
assumed_namestringPublic name of the organization. Also called DBA name.
display_namestringFull name of the organization. Constructed using name + assumed_name.
is_activeboolActive status of the organization.
addressstringAddress of the organization.
address2string
zipstringPostal code of the organization.
citystringCity where the organization is located.
statestringState where the organization is located.
countrystringCountry where the organization is located.
telephonestringOrganization telephone number.
containerobjectPrimary container the organization is attached to.
.. idintContainer ID.
.. parent_idstringID of the container’s parent.
.. namestringName of the container.
.. is_activeboolActive status of the container.
organization_contactobjectOrganization contact information.
.. idintOrganization contact ID.
.. first_namestringFirst name of the organization contact.
.. last_namestringLast name of the organization contact.
.. emailstringEmail address of the organization contact.
.. job_titlestringJob title for the organization contact.
.. telephonestringTelephone number of the organization contact.
.. telephone_extensionstringPhone extension for the organization contact.
verified_contactsarray of objectsList of verified contacts for the organization.
.. idintVerified 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.
.. namestringVerified contact name (first_name + last_name).
.. first_namestringVerified contact first name.
.. last_namestringVerified contact last name.
.. job_titlestringVerified contact job title.
.. telephonestringVerified contact telephone number
.. emailstringVerified contact email address.
.. verified_rolesarray of objectsList 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_typestringValidation type.
Possible values:EV, CS, EV_CS
.. .. statusstringStatus of the verified role.
Possible values:pending, valid, expired
ev_approversarray of objectsList of users that can approve EV and code signing orders. The list of users is returned only after the organization is validated.
.. idintUser ID.
.. first_namestringUser first name.
.. last_namestringUser last name.
extended_validationobjectExtended validation information about the organization.
container_id_assignmentsarrayList of containers the organization is assigned to.