Retrieve FileVault encryption details for a macOS device

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

gets the filevault info of the device

Request URL

https://{serverurl}/api/v1/mdm/devices/{device_id}/filevault

Scope

MDMOnDemand.MDMInventory.READCopied!

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Path Parameters

device_idstringMandatory

Unique identifier of the device. Obtain from the Get Device List response

- Query Parameters

searchkeystringOptional

Value to search for. Must be used in combination with searchfield to specify which field is searched

searchfieldstringOptional

Name of the field to search against. Used together with searchkey (e.g., name, email, udid)

is_allowed_appsbooleanOptional

Set to true to return apps from the allow list, false to return apps from the block list

is_app_purchased_from_portalbooleanOptional

Set to true to restrict results to apps purchased through the enterprise app portal (VPP/managed Google Play). Default: false

searchstringOptional

Free-text search string applied to the default searchable fields of the resource

app_scopestringOptional

Filter applications by their assignment scope. Allowed values: 1=All, 2=Assigned to groups, 3=Assigned to devices

platformstringOptional

Filter results by device platform. Allowed values: 1=iOS, 2=Android, 3=Windows, 4=macOS, 6=tvOS

delta-tokenstringOptional

Token used for delta/incremental fetches. Pass the token returned from a previous response to retrieve only items modified since that point

skip-tokenstringOptional

Pagination continuation token returned by a previous response. Pass it to fetch the next page of results

limitintegerOptional

Maximum number of records to return in a single response. Used together with offset for pagination

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomain/api/v1/mdm/devices/{device_id}/filevault \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
Show full

Response Parameters

- HTTP code 200

Response Body - application/json

JSON object
Hide Sub-Attributes
filevaultJSON object

FileVault encryption details for the macOS device

Show Sub-Attributes
filevault_statusinteger

FileVault status: 0 - Not compatible, 10 - Disabled, 20 - Enabled not through MDM, 21 - Enabled by MDM PKR only, 22 - Enabled by MDM IRK only, 23 - Enabled by MDM both

is_institution_recovery_keyboolean

Whether an Institutional Recovery Key is configured

is_personal_recovery_keyboolean

Whether a Personal Recovery Key is configured

resource_idlong

Resource identifier for the device

is_encryption_enabledboolean

Whether Full Disk Encryption is enabled

Possible HTTP Status Codes

200HTTP code

Sample Response: HTTP 200

FileVault encryption details for macOS device

Copied!
  {
    "filevault": {
      "filevault_status": 10,
      "is_institution_recovery_key": true,
      "is_personal_recovery_key": true,
      "resource_id": 9508000000013120,
      "is_encryption_enabled": false
    }
  }
                
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.