---
title: "GET /assets/{assetId}/messages"
method: GET
path: "/assets/{assetId}/messages"
tags: ["Assets - Messages"]
---

# GET /assets/{assetId}/messages

`GET /assets/{assetId}/messages`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `assetId` string, required

## Query parameters

- `StartDate` string, date-time, nullable
- `EndDate` string, date-time, nullable
- `MinAltitude` integer, nullable
- `MaxAltitude` integer, nullable
- `MinSpeed` integer, nullable
- `MaxSpeed` integer, nullable
- `Latitude` number, double, nullable
- `Longitude` number, double, nullable
- `Radius` integer, nullable
- `page` integer
- `size` integer

## Response `200`

- MessageList
  - `items` DeviceMessageModel[], required
    - `id` string
    - `createdDate` string, date-time
    - `priority` 'Low' | 'Medium' | 'High' | 'Emergency'
    - `position` PositionDataModel, required
      - `coordinates` LatLong, required
        - `latitude` number, double, required
        - `longitude` number, double, required
      - `date` string, date-time, required
      - `speed` number, double
      - `heading` number, double
      - `altitude` number, double
      - `satellites` integer
      - `hdop` number, double
      - `pdop` number, double, nullable
      - `valid` boolean
    - `device` DeviceDataModel
      - `odometer` integer, nullable
      - `batteryLevel` integer, nullable
      - `batteryVoltage` number, double, nullable
      - `batteryCurrent` number, double, nullable
    - `vehicle` VehicleDataModel
      - `odometer` integer, nullable
      - `ignition` boolean, nullable
      - `voltage` number, double, nullable
    - `gsm` GsmDataModel
      - `signalLevel` integer, nullable
      - `mobileCountryCode` string, nullable
      - `mobileNetworkCode` string, nullable
  - `averageSpeed` number, float, nullable
  - `averageAltitude` number, float, nullable
  - `totalCount` integer, required

## Other responses

- `404`

## Changes

> 56 revisions in range; 6 not diffed.

- **2026-07-17** `70d0b7ce1640`: 1 breaking
  - the `allOf[#/components/schemas/ListModelOfDeviceMessageModel]/items/items/position/date` response property's minLength was decreased from `1` to `0` for the response status `200`
- **2025-10-29** `23efffcab2bd`: 2 breaking
  - for the `query` request parameter `size`, default value was changed from `10000` to `1000`
  - for the `query` request parameter `size`, the max was decreased from `10000.00` to `1000.00`
- **2025-10-12** `210a6ec0a1eb`: 2 info
  - added `#/components/schemas/ListModelOfDeviceMessageModel` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/ListOfMessage` from the response body `allOf` list for the response status `200`
- **2024-11-16** `522dcbb4e6ef`: 4 info
  - api tag `Assets - Messages` added
  - api tag `AssetsMessages` removed
  - added `#/components/schemas/ListOfMessage` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/ListModelOfMessageModel` from the response body `allOf` list for the response status `200`
- **2024-09-07** `5dd4fbd6385a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/navtrack/apis/navtrack-api/changes/assets/:assetId/messages/get.md)

---

[API](https://skmtc.dev/navtrack/apis/navtrack-api.md) - [All operations](https://skmtc.dev/navtrack/apis/navtrack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/navtrack/apis/navtrack-api/revisions/70d0b7ce1640?raw)