# Retrieve all installed configuration profiles from a device gets the list of config profiles installed in device ## Endpoints **GET** `/api/v1/mdm/devices/{device_id}/configurationprofiles` ## Request URL ``` https://{serverurl}/api/v1/mdm/devices/{device_id}/configurationprofiles ``` ## Scope ``` MDMOnDemand.MDMInventory.READ ``` ## Header ``` Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52 ``` ## Request Parameters ### Path Parameters - **device_id** `string` (Mandatory) Unique identifier of the device. Obtain from the [Get Device List](https://www.manageengine.com/mobile-device-management/devices-get-device-list.html) response ### Query Parameters - **payload_identifier** `string` (Optional) - **installed_source** `integer` (Optional) ## Sample Request ### Curl ```bash curl --request GET \ --url https://appdomain/api/v1/mdm/devices/{device_id}/configurationprofiles \ --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/devices/{device_id}/configurationprofiles")) .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/devices/{device_id}/configurationprofiles", 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/devices/{device_id}/configurationprofiles" 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/devices/{device_id}/configurationprofiles' -Method GET -Headers $headers ``` ## Response Parameters ### HTTP code 200 **Response Body**: `application/json` - `configuration_profiles` `JSON array` Array of installed configuration profiles (both user-installed and MDM-installed) - `JSON object` - `payload_uuid` `string` Unique ID of the configuration profile. Returns `'unknown-uuid'` if not available - `payload_identifier` `string` Payload identifier string (e.g., com.apple.applebetasoftware) - `payload_description` `string` Full description of the configuration profile - `payload_organization` `string` Organization name that created the profile - `payload_type` `string` Apple-defined payload type - `payload_version` `integer` Payload version number - `payload_has_rem_password` `boolean` Whether the payload is removable with a password - `payload_is_encrypted` `boolean` Whether the payload content is encrypted - `payload_display_name` `string` Display name of the configuration profile - `payload_unremovable` `boolean` Whether the payload cannot be removed from the device - `payloadcontent` `JSON array` Array of individual payload content items within this profile - `JSON object` - `payload_uuid` `string` Unique identifier of the payload content item - `payload_identifier` `string` Payload identifier string - `payload_description` `string` Description of the payload content - `payload_organization` `string` Organization that created the payload - `payload_type` `string` Apple-defined payload type (e.g., com.apple.defaults.managed) - `payload_version` `integer` Payload version number - `payload_display_name` `string` Display name of the payload content ## Possible HTTP Status Codes - **200** HTTP code ## Sample Response: HTTP 200 MDM-installed and user-installed configuration profiles with payload details ```json { "configuration_profiles": [ { "payload_type": "com.apple.defaults.managed", "payload_has_rem_password": false, "payload_version": 1, "payload_identifier": "com.apple.applebetasoftware", "payload_uuid": "unknown-uuid", "payload_organization": "Unknown", "payloadcontent": [ { "payload_type": "com.apple.defaults.managed", "payload_version": 1, "payload_identifier": "com.apple.applebetasoftware.payload1", "payload_uuid": "unknown-uuid", "payload_organization": "Unknown", "payload_description": "No description available", "payload_display_name": "Payload 1" } ], "payload_is_encrypted": false, "payload_description": "No description available", "payload_display_name": "iOS Configuration Payload", "payload_unremovable": false } ] } ``` **Duration:** 1 minute | **Threshold:** 250 | **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.