--- title: "Organization info" source_url: https://dev.digicert.com/certcentral-apis/services-api/organizations/organization-info.html api_method: GET api_endpoint: "/services/v2/organization/{{organization_id}}" api_url: "https://www.digicert.com/services/v2/organization/{{organization_id}}" --- **GET** `https://www.digicert.com/services/v2/organization/{{organization_id}}` Use this endpoint to get details about an organization. ## Example requests and responses **cURL** ```bash curl -X GET \ 'https://www.digicert.com/services/v2/organization/{{organization_id}}' \ -H 'Content-Type: application/json' \ -H 'X-DC-DEVKEY: {{api_key}}' ``` **Python** ```python 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) ``` **Go** ```go 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)) } ``` **NodeJS** ```javascript 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); }); ``` **200 OK** ```json { "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" } } ``` **200 OK (EV validated org)** ```json { "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. |