# Retrieve MDM profile installation status

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

## Endpoint

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

## Request URL

`https://{server-hostname}:8383/dcapi/som/computers/actionRequest/mdm-profile/install/status`

## Scope

`SOM.READ`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

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

## Sample Request

### Curl

```curl
curl --request GET \
  --url https://appdomain/dcapi/som/computers/actionRequest/mdm-profile/install/status \
  --header 'Accept: application/mdmProfileInstallationStatus.v1+json' \
  --header 'Authorization:  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/dcapi/som/computers/actionRequest/mdm-profile/install/status"))
        .header("Accept", "application/mdmProfileInstallationStatus.v1+json")
        .header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();
    HttpResponse<string> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());

  }
}
```

### Python

```python
import http.client

conn = http.client.HTTPSConnection("appdomain")

headers = {
    'Accept': "application/mdmProfileInstallationStatus.v1+json",
    'Authorization': " d92d4xxxxxxxxxxxxx15f52"
    }

conn.request("GET", "/dcapi/som/computers/actionRequest/mdm-profile/install/status", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
```

### Deluge

```javascript
headersMap = Map();
headersMap.put("Accept", "application/mdmProfileInstallationStatus.v1+json");

response = invokeUrl
[
    url: "https://appDomain/dcapi/som/computers/actionRequest/mdm-profile/install/status"
    type: GET
    headers: headersMap
    connection: connection_name
]

info response;
```

### PowerShell

```powershell
$headers=@{}
$headers.Add("Accept", "application/mdmProfileInstallationStatus.v1+json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/dcapi/som/computers/actionRequest/mdm-profile/install/status' -Method GET -Headers $headers
```

## Response Parameters

### HTTP code 200

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

| Parameter | Type | Description |
|---|---|---|
| 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
}
```

**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.