---
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`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/telemetry/query`
- Auth: HTTP bearer

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.dev/starlink/apis/starlink-telemetry-cache-api.md) - [All operations](https://skmtc.dev/starlink/apis/starlink-telemetry-cache-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlink/apis/starlink-telemetry-cache-api/revisions/cbee626b66a5?raw)