Retrieve the current blocklist enforcement status on devices

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

Get blocklist status

Endpoints

Request URL

https://{server-hostname}:8383/api/v1/mdm/blacklist/status

Scope

MDMInventory.READCopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory
application/jsonapplication/jsonCopied!

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomain/api/v1/mdm/blacklist/status \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Hide Sub-Attributes
BlackliststatusJSON Array

Array of blocklist status entries per device and app

Show Sub-Attributes
JSON Object
Show Sub-Attributes
statusinteger

Status code of the blocklist enforcement command: 1=Yet To Apply, 2=Notified, 3=In Progress, 4=Applied, 5=Not Applicable, 6=Yet To Remove, 7=Remove In Progress, 8=Removed, 9=Failed, 10=Removal Failed, 11=Disabled

resourceIdlong

Resource ID of the device or group

identifierstring

Unique identifier (bundle ID / package name) of the app

appnamestring

Display name of the app

Possible Response Codes

200HTTP code

Sample Response: HTTP 200

Blocklist status for multiple devices and apps showing various enforcement states

Copied!
  {
    "Blackliststatus": [
      {
        "identifier": "com.manageengine.mdm.android",
        "resourceId": 9007199254741064,
        "appname": "Zylker MDM",
        "status": 4
      },
      {
        "identifier": "com.zylker.chatapp",
        "resourceId": 9007199254741064,
        "appname": "Chat App",
        "status": 1
      },
      {
        "identifier": "com.zylker.testapp",
        "resourceId": 9007199254741064,
        "appname": "Test App",
        "status": 9
      }
    ]
  }
                
Show full

No blocklist enforcement entries found

Copied!
  {
    "Blackliststatus": []
  }
                
Show full

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.