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

# Get Device Historian Messages

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

## Request

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

Get historic message data for a specific SIM device.

## Path parameters

- `deviceId` string, required

## Query parameters

- `startDateTime` string
- `endDateTime` string
- `pageSize` integer
- `protocol` string
- `nextToken` string

## Response `200`

OK

- GetResponseschema6: Get all device messages from the historian.
  - `items` GetResponseschema6ItemsInner[], required: List of messages.
    - `iccid` string, required: Iccid of the device.
    - `time` string, date-time, required: Time when message was received.
    - `payload` string, required: Stringified JSON object or base64 encoded string.
    - `protocol` 'UDP' | 'COAP' | 'LWM2M', required: The protocol used to communicate.
    - `deviceId` string, required: The unique ID of the device.
    - `topic` string: The MQTT topic that was passed with the CoAP message (not present if no topic was set).
  - `nextToken` string: This API query uses token-based pagination. A queried page will include a nextToken for accessing the next page for pagination if a further page is available. Please use the returned token in the nextToken query parameters to obtain the next page.
  - `firstToken` string: When no nextToken is passed as part of the query parameters, the firstToken is provided as reference to the first page of the queried pages.

## 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)