# Retrieve detailed information about a specific managed device

gets particular device's inventory details

## Endpoint

`GET /api/v1/mdm/devices/{device_id}`

## Request

### Request URL

https://[{serverurl}](https://www.manageengine.com/mobile-device-management/help/api/cloud/oauth-authentication-endpoint-domain.html)/api/v1/mdm/devices/{device_id}

### Scope

`MDMOnDemand.MDMInventory.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** `string` — **Mandatory**
  - `application/json`

#### Path Parameters

- **device_id** `string` — **Mandatory**
  - Unique identifier of the device. Obtain from the [Get Device List](https://www.manageengine.com/mobile-device-management/help/api/cloud/devices-get-device-list.html) response

#### Query Parameters

- **searchkey** `string` — Optional
  - Value to search for. Must be used in combination with searchfield to specify which field is searched
- **searchfield** `string` — Optional
  - Name of the field to search against. Used together with searchkey (e.g., name, email, udid)
- **is_allowed_apps** `boolean` — Optional
  - Set to true to return apps from the allow list, false to return apps from the block list
- **is_app_purchased_from_portal** `boolean` — Optional
  - Set to true to restrict results to apps purchased through the enterprise app portal (VPP/managed Google Play). Default: false
- **search** `string` — Optional
  - Free-text search string applied to the default searchable fields of the resource
- **app_scope** `string` — Optional
  - Filter applications by their assignment scope. Allowed values: 1=All, 2=Assigned to groups, 3=Assigned to devices
- **platform** `string` — Optional
  - Filter results by device platform. Allowed values: 1=iOS, 2=Android, 3=Windows, 4=macOS, 6=tvOS
- **delta-token** `string` — Optional
  - Token used for delta/incremental fetches. Pass the token returned from a previous response to retrieve only items modified since that point
- **skip-token** `string` — Optional
  - Pagination continuation token returned by a previous response. Pass it to fetch the next page of results
- **limit** `integer` — Optional
  - Maximum number of records to return in a single response. Used together with offset for pagination
- **summary** `boolean` — Optional
  - When true, returns only a lightweight summary projection of the resource instead of full details. Default: false
- **include** `string` — Optional
  - Include group name in the response. Allowed value: groupName. When omitted, only top-level fields are returned

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/api/v1/mdm/devices/{device_id} \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### HTTP 200

Response body: `application/json`

- `JSON object`
  - **warranty_number** `string`
    - Warranty number of the device
  - **cellular_technology** `integer`
    - Cellular technology type: 1 - None, 2 - GSM, 3 - CDMA
  - **used_device_space** `string`
    - Amount of device space used (GB)
  - **is_ios_native_app_registered** `boolean`
    - Whether the native iOS app is registered on the device
  - **warranty_expiration_date** `long`
    - Warranty expiration date in milliseconds since epoch
  - **purchase_order_number** `string`
    - Purchase order number
  - **model** `string`
    - Device model identifier
  - **available_external_capacity** `string`
    - Available free external storage space (GB)
  - **available_ram_memory** `integer`
    - Available free RAM in megabytes
  - **owned_by** `string`
    - Device ownership: 1 - Corporate, 2 - Personal
  - **warranty_type** `string`
    - Type of warranty (e.g., WithService)
  - **modem_firmware_version** `string`
    - Baseband/modem firmware version
  - **purchase_price** `integer`
    - Purchase price of the device
  - **purchase_date** `long`
    - Purchase date in milliseconds since epoch
  - **managed_status** `integer`
    - Management status: 0 - Failed, 1 - Yet to enroll, 2 - Enrolled, 3 - Waiting approval, 4 - Unmanaged, 5 - Waiting user assignment
  - **network_usage** `JSON object`
    - Network usage details for the device
  - **sims** `JSON array`
    - Array of SIM card details
  - **external_capacity** `string`
    - Total external storage capacity (GB)
  - **knox_details** `JSON object`
    - Samsung Knox container details
  - **asset_owner** `string`
    - Owner of the device asset
  - **apn_password** `string`
    - APN password
  - **battery_level** `integer`
    - Current battery level percentage
  - **is_itunes_account_active** `boolean`
    - Whether the iTunes Store account is active
  - **is_supervised** `boolean`
    - Whether the device is supervised (iOS)
  - **serial_number** `string`
    - Device serial number
  - **last_cloud_backup_date** `string`
    - Date of last cloud backup (-1 = never backed up)
  - **agent_version_code** `string`
    - Agent version code (-1 = not available)
  - **meid** `string`
    - Mobile Equipment Identifier
  - **is_dnd_in_effect** `boolean`
    - Whether Do Not Disturb is currently active
  - **office** `string`
    - Office location assigned to the device
  - **apn_username** `string`
    - APN username
  - **model_name** `string`
    - Device model name
  - **registered_time** `string`
    - Device registration timestamp
  - **purchase_type** `string`
    - Purchase type (e.g., Reseller, Vendor)
  - **asset_tag** `string`
    - Asset tag assigned to the device
  - **is_activation_lock_enabled** `boolean`
    - Whether Activation Lock is enabled (iOS)
  - **available_device_capacity** `string`
    - Available free device storage capacity (GB)
  - **product_name** `string`
    - Product/manufacturer name
  - **agent_type** `integer`
    - Agent type: 1 - iOS Profile, 2 - Android Core Agent, 3 - SAFE Agent
  - **is_device_locator_enabled** `boolean`
    - Whether the device locator service is enabled
  - **device_capacity** `string`
    - Total device storage capacity (GB)
  - **added_time** `string`
    - Timestamp when device was added to management
  - **eas_device_identifier** `string`
    - Exchange ActiveSync device identifier
  - **description** `string`
    - Description of the device
  - **is_lost_mode_enabled** `boolean`
    - Whether Lost Mode is enabled
  - **network** `JSON object`
    - Network usage details
  - **device_name** `string`
    - Assigned device name
  - **security** `JSON object`
    - Device security details
  - **udid** `string`
    - Unique Device Identifier
  - **summary** `JSON object`
    - Summary counts for profiles, apps, documents, and groups
  - **os** `JSON object`
    - Operating system details
  - **is_cloud_backup_enabled** `boolean`
    - Whether cloud backup is enabled
  - **model_type** `integer`
    - Model type number
  - **model_id** `string`
    - Model identifier
  - **total_ram_memory** `integer`
    - Total RAM in megabytes
  - **used_external_space** `string`
    - Used external storage space (GB)
  - **remarks** `string`
    - Remarks about the device
  - **unregistered_time** `integer`
    - Unregistered timestamp (-1 = still registered)

### Sample Response: HTTP 200

Comprehensive device details including hardware, network, security, and OS info

```json
{
  "warranty_number": "SJSU64728372",
  "agent_version_code": "-1",
  "meid": "SM-G935F",
  "cellular_technology": 1,
  "is_dnd_in_effect": false,
  "used_device_space": "12.86491",
  "is_ios_native_app_registered": false,
  "office": "North Plaza,CA",
  "apn_username": "zylker",
  "warranty_expiration_date": 1530057600000,
  "model_name": "hero2ltexx",
  "registered_time": "1540655566627",
  "purchase_order_number": "SR2Ik56779",
  "model": "SM-G935F",
  "purchase_type": "Reseller",
  "available_external_capacity": "20.47",
  "asset_tag": "TestDevice",
  "is_activation_lock_enabled": true,
  "available_device_capacity": "13.200405",
  "available_ram_memory": 983,
  "owned_by": "2",
  "warranty_type": "WithService",
  "product_name": "samsung",
  "agent_type": 1,
  "modem_firmware_version": "10.10.00",
  "is_device_locator_enabled": true,
  "purchase_price": 65000,
  "purchase_date": 1527984000000,
  "device_capacity": "24.81",
  "managed_status": 2,
  "added_time": "1523370360750",
  "network_usage": {
    "outgoing_network_usage": 0,
    "device_id": "9007199254741001",
    "incoming_wifi_usage": 0,
    "outgoing_wifi_usage": 0,
    "incoming_network_usage": 0
  },
  "eas_device_identifier": "QEGJKADSR14D1AEAA4F29FM0IC",
  "sims": [
    {
      "subscriber_carrier_network": "--",
      "iccid": 8991400912981718000,
      "is_roaming": true,
      "sim_id": 9508000000013204,
      "current_mnc": 40,
      "subscriber_mnc": 40,
      "current_carrier_network": "--",
      "resource_id": 9508000000013120,
      "imei": 357327071694307,
      "subscriber_mcc": "in",
      "current_mcc": "in"
    }
  ],
  "description": "Belong to Zylker Inc",
  "is_lost_mode_enabled": false,
  "network": {
    "outgoing_network_usage": 0,
    "device_id": "9007199254741001",
    "incoming_wifi_usage": 0,
    "outgoing_wifi_usage": 0,
    "incoming_network_usage": 0
  },
  "external_capacity": "29.82",
  "device_name": "admin_SM-G935F",
  "security": {
    "passcode_complaint": false,
    "external_storage_encryption": -1,
    "storage_encryption": false,
    "hardware_encryption_caps": -1,
    "passcode_complaint_profiles": true,
    "device_rooted": false,
    "passcode_present": false
  },
  "knox_details": {
    "container_state": "-1",
    "knox_version": "2",
    "container_status": "20004",
    "container_remarks": null,
    "container_last_updated_time": "-1"
  },
  "asset_owner": "Sysadmin",
  "udid": "f8c4071d394ef48e",
  "apn_password": null,
  "summary": {
    "doc_count": "1",
    "group_count": "2",
    "profile_count": "5",
    "app_count": "10"
  },
  "battery_level": 22,
  "is_itunes_account_active": true,
  "os": {
    "platform_type": "android",
    "build_version": "NRD90M",
    "os_version": "8.0.0",
    "resource_id": 9508000000013120,
    "serial_number": "2321bkbkqgidga1"
  },
  "is_cloud_backup_enabled": false,
  "is_supervised": false,
  "model_type": 1,
  "serial_number": "2321bkbkqgidga1",
  "model_id": "9007199254740997",
  "last_cloud_backup_date": "-1",
  "total_ram_memory": 3533,
  "used_external_space": "25.38",
  "remarks": "--",
  "unregistered_time": -1
}
```

### Possible Response Codes

- **200** `HTTP code`

## Rate Limit

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