# Retrieve MDM profile installation status

Retrieves the status of an MDM profile installation action request including total, completed, applicable, and failure counts.

## Endpoints

`GET /dcapi/som/computers/actionRequest/mdm-profile/install/status`

## Request URL

`https://{serverurl}/dcapi/som/computers/actionRequest/mdm-profile/install/status`

## Scope

`DesktopCentralCloud.SOM.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` — **Mandatory**
  - `application/mdmProfileInstallationStatus.v1+json`

### Query Parameters

- **actionRequestID** `string` — Optional
  - The action request ID returned from the MDM profile installation endpoint. If not provided, the latest status for the user will be returned. Get the action request ID from [here](https://www.manageengine.com/products/desktop-central/help/api/cloud/computers-install-mdmprofile.html).

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/som/computers/actionRequest/mdm-profile/install/status \
  --header 'Accept: application/mdmProfileInstallationStatus.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body — `application/json`

`JSON Object`

- **actionRequestID** `long`
  - Numeric tracking identifier of the MDM profile installation action request
- **totalComputerCount** `string`
  - Total number of computers included in this MDM profile installation batch
- **completedComputerCount** `string`
  - Number of computers where the MDM profile installation has finished (either succeeded or failed)
- **mdmEnrollmentInProgress** `boolean`
  - Indicates whether the MDM enrollment process is still running. false when all computers have been processed
- **selectedComputersCount** `string`
  - Total number of computers originally selected for installation. Present only after the operation completes
- **applicableComputersCount** `string`
  - Number of computers that met the prerequisites for MDM installation. Present only after the operation completes
- **notApplicableComputersCount** `string`
  - Number of computers that did not meet the prerequisites for MDM installation. Present only after the operation completes
- **successComputersCount** `string`
  - Number of computers where the MDM profile was installed successfully. Present only after the operation completes
- **failureComputersCount** `string`
  - Number of computers where the MDM profile installation failed. Present only after the operation completes

## Possible Response Codes

- **200** `HTTP code`

## Sample Response: HTTP 200

### MDM installation in progress

```json
{
  "totalComputerCount": 5,
  "completedComputerCount": 2,
  "mdmEnrollmentInProgress": true,
  "actionRequestID": 1712567890123
}
```

### MDM installation completed

```json
{
  "totalComputerCount": 5,
  "completedComputerCount": 5,
  "applicableComputersCount": "4",
  "notApplicableComputersCount": "1",
  "failureComputersCount": "1",
  "mdmEnrollmentInProgress": false,
  "selectedComputersCount": "5",
  "successComputersCount": "3",
  "actionRequestID": 1712567890123
}
```

![ ](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **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.