# Retrieve summary information for a specific managed device

Get the device specific summary

## Endpoint

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

## Request

### Request URL

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

### Scope

`MDMDeviceMgmt.READ`

### Header

`Authorization: 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/products/desktop-central/help/api/onpremise/devices-get-device-list.html) response

## Sample Request

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

## Response Parameters

### HTTP Code 200

#### Response Body — application/json

`JSON Object`

- **agent_version** (`string`): MDM agent version installed on the device
- **device_name** (`string`): Assigned device name
- **doc_count** (`string`): Number of documents on the device
- **device_id** (`string`): Unique device identifier
- **group_count** (`string`): Number of groups the device belongs to
- **platform_type** (`string`): Platform type (e.g., android, ios, windows)
- **last_contact_time** (`string`): Last contact time in milliseconds since epoch
- **profile_count** (`string`): Number of profiles installed
- **app_count** (`string`): Number of apps on the device
- **group** (`JSON Array`): Array of groups the device belongs to

## Possible Response Codes

- **200** (`HTTP code`)

## Sample Response: HTTP 200

Device summary with counts and group membership

```json
{
  "agent_version": "9.2.432.A",
  "device_name": "admin_SM-G935F",
  "doc_count": "1",
  "device_id": "9007199254741001",
  "group_count": "2",
  "platform_type": "android",
  "last_contact_time": "1557128715277",
  "profile_count": "5",
  "app_count": "10",
  "group": [
    {
      "group_id": "9007199254741633",
      "group_name": "Test group 1557134860919"
    }
  ]
}
```

## Rate Limits

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

**Duration:** 1 minute | **Threshold:** 120 | **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.