# Retrieve detailed information about a specific managed device

gets particular device's inventory details

## Endpoint

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

## Request URL

```text
https://{server-hostname}:8383/api/v1/mdm/devices/{device_id}
```

## Scope

```text
MDMInventory.READ
```

## Header

```text
Authorization: d92d4xxxxxxxxxxxxx15f52
```

## Request Parameters

### Request Headers

| Parameter | Type | Required | Value | Description |
|---|---|---|---|---|
| Accept | string | Mandatory | `application/json` |  |

### Path Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| device_id | string | Mandatory | Unique identifier of the device. Obtain from the [Get Device List](https://www.manageengine.com/products/desktop-central/help/api/onpremise/devices-get-device-list.html) response |

### Query Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| 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

```bash
curl --request GET \
  --url 'https://appdomain/api/v1/mdm/devices/{device_id}?searchkey=SOME_STRING_VALUE&searchfield=SOME_STRING_VALUE&is_allowed_apps=SOME_BOOLEAN_VALUE&is_app_purchased_from_portal=SOME_BOOLEAN_VALUE&search=SOME_STRING_VALUE&app_scope=SOME_STRING_VALUE&platform=SOME_STRING_VALUE&delta-token=SOME_STRING_VALUE&skip-token=SOME_STRING_VALUE&limit=SOME_INTEGER_VALUE&summary=SOME_BOOLEAN_VALUE&include=SOME_STRING_VALUE' \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

Response body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| 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) |

## Possible Response Codes

| Code | Type |
|---|---|
| 200 | HTTP code |

## 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
}
```

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

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