Retrieve MDM profile installation status

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

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

Request URL

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

Scope

SOM.READCopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory
application/mdmProfileInstallationStatus.v1+jsonapplication/mdmProfileInstallationStatus.v1+jsonCopied!

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomain/dcapi/som/computers/actionRequest/mdm-profile/install/status \
  --header 'Accept: application/mdmProfileInstallationStatus.v1+json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Hide Sub-Attributes
actionRequestIDlong

Numeric tracking identifier of the MDM profile installation action request

totalComputerCountstring

Total number of computers included in this MDM profile installation batch

completedComputerCountstring

Number of computers where the MDM profile installation has finished (either succeeded or failed)

mdmEnrollmentInProgressboolean

Indicates whether the MDM enrollment process is still running. false when all computers have been processed

selectedComputersCountstring

Total number of computers originally selected for installation. Present only after the operation completes

applicableComputersCountstring

Number of computers that met the prerequisites for MDM installation. Present only after the operation completes

notApplicableComputersCountstring

Number of computers that did not meet the prerequisites for MDM installation. Present only after the operation completes

successComputersCountstring

Number of computers where the MDM profile was installed successfully. Present only after the operation completes

failureComputersCountstring

Number of computers where the MDM profile installation failed. Present only after the operation completes

Possible Response Codes

200HTTP code

Sample Response: HTTP 200

MDM installation in progress

Copied!
  {
    "totalComputerCount": 5,
    "completedComputerCount": 2,
    "mdmEnrollmentInProgress": true,
    "actionRequestID": 1712567890123
  }
                
Show full

MDM installation completed

Copied!
  {
    "totalComputerCount": 5,
    "completedComputerCount": 5,
    "applicableComputersCount": "4",
    "notApplicableComputersCount": "1",
    "failureComputersCount": "1",
    "mdmEnrollmentInProgress": false,
    "selectedComputersCount": "5",
    "successComputersCount": "3",
    "actionRequestID": 1712567890123
  }
                
Show full

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.