Satellite and ground station telemetry API
Constellation takes one telemetry record per ground-to-satellite link: a time, the link's three IDs from your network config, and measured fields such as Es/N0, elevation and slant range. Everything else, fleet state, series reads and calibrated forecasts, is read from those records.
Three ways in
| Path | Use it when | Reference |
|---|---|---|
POST /telemetry over HTTPS | A backend or script sends batches, up to 1,000 records per request | Telemetry |
gRPC TelemetryIngest.Write | A high-rate producer, with a live key that has telemetry:write | gRPC ingest |
| The fleet agent | Applications on your hosts publish to a local socket; the agent buffers to disk and delivers, so they never hold the API key | Fleet agent |
Flown passes go in as a CSV with POST /telemetry/pass-logs, and files in any other format through telemetry files.
A record
[
{
"time": "2026-11-10T12:00:00Z",
"ground_station_id": "gs-1",
"ground_antenna_id": "ant-1",
"satellite_id": "sat-1",
"fields": { "es_n0_db": 12.5, "elevation_deg": 45.0, "range_m": 1200000.0 }
}
]
Every ID must be in your latest network config, and every field is from a fixed list with a fixed type.
Reading it back
GET /topologyreturns the newest value of each field per link within a freshness window.- Series reads return a link's records over a time range, raw or aggregated.
- Stepping
as_of_utcreplays the fleet as it was known at each instant.
Why it matters for forecasts
Link SNR learns each antenna from the records you send. Write one record per link at least once a minute while the link is in view, with es_n0_db, elevation_deg and range_m, and the forecast moves from a datasheet link budget toward what your link measures.
Common questions
What happens when part of a telemetry batch is invalid?
The API answers 202 with the rejected records listed by index. Correct those records and resend only them, so accepted records are not written twice.
Can I send telemetry in my own format?
Yes. Files the API has no dedicated route for go to telemetry files, in any format under a source label you choose, over HTTPS or SFTP for large files.
Do I need telemetry to get forecasts?
Not for every model. Weather attenuation and Satellite demand need none. Link SNR forecasts from the link budget without it and learns from telemetry once it arrives.