---
title: "Get the most recent device health data, mapped to enterprise response format"
method: POST
path: "/public/v2/telemetry/query"
tags: ["Cache"]
---

# Get the most recent device health data, mapped to enterprise response format

`POST /public/v2/telemetry/query`

Required permission: Device telemetry, View.<br/>Returns the most recent telemetry values for each requested device in a structured dictionary form. For each device type there is an entry mapping device id to a fully typed telemetry object.

## Request body

- EnterpriseCacheSearchRequest
  - `includeUserTerminals` boolean, nullable — Whether to include user terminal telemetry data, optionally filtered to only the requested terminals. If UserTerminalIds is null or empty all terminals telemetry data will be included
  - `userTerminalIds` string[], nullable — List of userTerminalIds to filter by if IncludeUserTerminals is true. If omitted and IncludeUserTerminals is true then telemetry data for all terminals will be included
  - `includeRouters` boolean, nullable — Whether to include router telemetry data, optionally filtered to only the requested routers. If RouterIds is null or empty all routers telemetry data will be included
  - `routerIds` string[], nullable — List of routerIds to filter by if IncludeRouters is true. If omitted and IncludeRouters is true then telemetry data for all routers will be included

## Response `200`

Most recent device health data

- EnterpriseCacheSearchResponseServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` EnterpriseCacheSearchResponse
    - `userTerminals` object, nullable — Dictionary of userTerminalId to most recent telemetry data point for that device
    - `routers` object, nullable — Dictionary of routerId to most recent telemetry data point for that device

## Other responses

- `400` — Bad Request
- `401` — Users token expired
- `403` — Forbidden from retrieving device data
- `422` — Unprocessable Content
- `500` — Failed to find data for this account

---

[API](https://skmtc.net/starlink/apis/starlink-management-api.md) · [All operations](https://skmtc.net/starlink/apis/starlink-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/starlink/starlink-management-api/revisions/a730bd0ddb42/schema)