---
title: "Returns list of device heartbeats"
method: GET
path: "/v1/Devices/{deviceId}/heartbeats"
tags: ["Devices"]
---

# Returns list of device heartbeats

`GET /v1/Devices/{deviceId}/heartbeats`

## Path parameters

- `deviceId` string, uuid, required

## Query parameters

- `Filter` string
- `Page` integer
- `PageSize` integer
- `SortColumn` string
- `SortOrder` string
- `Account` unknown

## Response `200`

Success

- DeviceHeartbeatResponse[]
  - `id` integer
  - `deviceId` string, uuid
  - `osVersion` string, nullable
  - `appVersion` string, nullable
  - `batteryPercentage` integer
  - `batteryCurrentNow` integer
  - `batteryCurrentAverage` integer
  - `batteryVoltage` integer
  - `batteryStatus` string, nullable
  - `unsentSessions` integer
  - `unfinishedSessions` integer
  - `ioid` string, nullable
  - `received` string, date-time
  - `heartbeatUserInfo` DeviceHeartbeatUserinfoResponse[], nullable
    - `heartbeatId` integer
    - `unfinishedScans` integer
    - `unfinishedSessions` integer
    - `unsentSessions` integer
    - `unsentScans` integer
    - `username` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/invendor/apis/io-commonapi.md) · [All operations](https://skmtc.net/invendor/apis/io-commonapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/invendor/io-commonapi/versions/0e4626e69155/schema)