---
title: "Get Device Historian Insights"
method: GET
path: "/v1/inspect/devices/{deviceId}/history/insights"
tags: ["Device Inspector"]
---

# Get Device Historian Insights

`GET /v1/inspect/devices/{deviceId}/history/insights`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/inspect/devices/{deviceId}/history/insights`
- Auth: HTTP bearer

Get insights of a unique SIM device for the Historian.

## Path parameters

- `deviceId` string, required

## Query parameters

- `startDateTime` string
- `endDateTime` string
- `protocol` string
- `interval` string

## Response `200`

OK

- GetResponseschema7: Get the devices history insights for a specific time range.
  - `items` GetResponseschema7ItemsInner[], required: List of messages.
    - `time` string, date-time, required: Date of the device statistics.
    - `protocol` 'UDP' | 'COAP' | 'LWM2M', required: Protocol of the message.
    - `amount` number, required: Amount of messages.
  - `interval` string, required: Interval of the message statistics, like 1h.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)