---
title: "Retrieve live data from a device"
method: GET
path: "/rest/manager/live/getlivedata/{deviceid}"
tags: ["Device live data APIs"]
---

# Retrieve live data from a device

`GET /rest/manager/live/getlivedata/{deviceid}`

## Request

- Base URL: `https://masonconsole.com`
- URL: `https://masonconsole.com/rest/manager/live/getlivedata/{deviceid}`
- Auth: HTTP bearer

This endpoint allows the retrieval of live data from a specific device identified by its device ID. Device authentication is required. Upon receiving the request, the API triggers the retrieval of live data from the device through a background task. The live data is collected and stored in a container associated with the device session. The API returns the live data response, containing telemetry information and other relevant device data. The API has a rate limit of 1 API call for each user and device every 1 minute.

## Path parameters

- `deviceid` string, required

## Query parameters

- `include` string

## Response `200`

Successful response

- ResponseMetaData
  - `data` object
  - `result` string
  - `message` string
  - `@class` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal server error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/bymason/apis/mason-device-console-api-docs.md) - [All operations](https://skmtc.dev/bymason/apis/mason-device-console-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/bymason/apis/mason-device-console-api-docs/revisions/d9cdcc14b7d1?raw)
