# Retrieve the full configuration details of an ADCS server Get the individual ADCS server details ## Endpoints **GET** `/api/v1/mdm/adcs/servers/{ad_config_id}` ## Request URL ``` https://{serverurl}/api/v1/mdm/adcs/servers/{ad_config_id} ``` ## Scope ``` MDMOnDemand.MDMDeviceMgmt.READ ``` ## Header ``` Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52 ``` ## Request Parameters ### Path Parameters - **ad_config_id** (string) — Mandatory Unique identifier of the ADCS configuration. Use the ad_config_id from the [Add ADCS Server API](https://www.manageengine.com/mobile-device-management/help/api/cloud/mac-add-adcs-server.html) response ### Query Parameters - **t** (long) — Optional - **ignoreHeader** (boolean) — Optional - **qlt** (long) — Optional - **previousTab** (string) — Optional - **service** (string) — Optional - **search** (string) — Optional Free-text search string applied to the default searchable fields of the resource - **all** (boolean) — Optional - **dc_customerid** (long) — Optional - **mdm_instance** (string) — Optional - **signupsrc** (string) — Optional - **zaaid** (string) — Optional - **command** (string) — Optional - **orderby** (string) — Optional - **sortorder** (string) — Optional - **select_all** (boolean) — Optional When true, applies the operation to every record matching the current filter rather than to specific IDs. Default: false - **zoho-internal** (boolean) — Optional - **dc_instance** (string) — Optional - **SUBREQUEST** (string) — Optional - **source** (string) — Optional - **nocache** (long) — Optional param to avoid being served from cache - **wms_csrparam** (string) — Optional CSRF Token ## Sample Request ### Curl ```bash curl --request GET \ --url https://appdomain/api/v1/mdm/adcs/servers/{ad_config_id} \ --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' ``` ### Java ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.io.IOException; import java.net.http.HttpTimeoutException; public class Main { public static void main(String[] args) { HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://appdomain/api/v1/mdm/adcs/servers/{ad_config_id}")) .header("Authorization", "Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52") .method("GET", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } } ``` ### Python ```python import http.client conn = http.client.HTTPSConnection("appdomain") headers = { 'Authorization': "Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52" } conn.request("GET", "/api/v1/mdm/adcs/servers/{ad_config_id}", headers=headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ### Deluge ```javascript headersMap = Map(); headersMap.put("Accept", "application/json"); response = invokeUrl [ url: "https://appDomain/api/v1/mdm/adcs/servers/{ad_config_id}" type: GET headers: headersMap connection: connection_name ] info response; ``` ### PowerShell ```powershell $headers=@{} $headers.Add("Authorization", "Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52") $response = Invoke-WebRequest -Uri 'https://appdomain/api/v1/mdm/adcs/servers/{ad_config_id}' -Method GET -Headers $headers ``` ## Response Parameters ### HTTP 200 **Response Body**: `application/json` **Type**: JSON object #### Attributes - **ad_config_id** (long) Unique identifier of the newly created ADCS configuration - **ad_config_name** (string) Name of the ADCS configuration - **cert_server_address** (string) URL of the ADCS server - **cert_authority** (string) Common Name (CN) of the Certificate Authority - **cert_template_name** (string) Template name of the certificate - **description** (string) Description of the ADCS server configuration - **cert_exp_notify_thread** (integer) Number of days before certificate expiry to notify - **rsa_key_size** (integer) RSA key size for the certificate. 0 = 1024, 1 = 2048, 2 = 4096 - **auto_renew_enabled** (boolean) Whether auto-renewal is enabled - **allow_all_apps_to_access** (boolean) Whether all apps can access the certificate ## Possible Response Codes - **200** — HTTP code ## Sample Response: HTTP 200 ADCS server configuration details ```json { "ad_config_name": "computer_1", "cert_authority": "CN=zylker-SERVER-CA2", "auto_renew_enabled": true, "cert_exp_notify_thread": 14, "allow_all_apps_to_access": true, "description": "ADCS server for computer certificates", "cert_template_name": "computer_1", "cert_server_address": "http://cert.zylker.com/certsrv/", "ad_config_id": 9007199254744896, "rsa_key_size": 1 } ``` ## Rate Limiting **Duration:** 1 minute **Threshold:** 120 **Lock period:** 5 minutes - **Duration** — Time window for the threshold. - **Threshold** — Number of API calls allowed within the specified duration. - **Lock Period** — Wait time before consecutive API requests.