---
title: "Get telemetry"
method: POST
path: "/public/v2/telemetry/stream"
tags: ["Stream"]
---

# Get telemetry

`POST /public/v2/telemetry/stream`

## Request

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

Required permission: Device telemetry, View.<br/>Get telemetry data of size 'batchSize'. Data is retrieved for all devices of the account associated with the used API credentials. Can be called repeatedly to generate a stream of data. See https://starlink.readme.io/docs/telemetry-api for more.

## Request body

- StreamBatchRequestV2
  - `batchSize` integer: The number of device data records to return per batch. Max 65000. Default 1000.
  - `maxLingerMs` integer: The maximum amount of time in milliseconds to block for while collecting device data records. Max 65000 (65s). Default 15000 (15s).

## Response `200`

Latest batch of data retrieved from devices

## Other responses

- `400`: Bad Request
- `401`: Must use v2 service account
- `403`: Missing required permission for retrieving device telemetry
- `500`: Failed to find data for this account

---

[API](https://skmtc.dev/starlink/apis/starlink-telemetry-stream-api.md) - [All operations](https://skmtc.dev/starlink/apis/starlink-telemetry-stream-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlink/apis/starlink-telemetry-stream-api/revisions/766689d5dcce?raw)