Skip to content

Telemetry

Telemetry is the live operational data a robot reports: its position, heading, mission progress, and health.

What it represents

Each robot continuously reports telemetry while it operates. Over REST you read the latest known values as point-in-time snapshots. For a continuous, high-frequency stream, use the real-time channel described under Real-time streaming rather than polling these endpoints.

Authentication

Telemetry endpoints are called with an API key and require the robots:read permission. See Authentication.

Last-known position

GET /v1/orgs/{org_id}/fleets/{fleet_id}/robots/{robot_id}/position

Returns the robot's most recent reported position.

Response:

{
  "robot_id": "a1b2…",
  "latitude": 45.5,
  "longitude": -122.6,
  "elevation_m": 30.0,
  "heading_deg": 90.0,
  "gps_fix": "fixedRtk",
  "timestamp": "2026-06-18T17:00:00Z",
  "source": "telemetry"
}

gps_fix is the quality of the position fix (for example gps, dgps, floatRtk, fixedRtk, or unknown). timestamp is when the position was last updated. Fields are null when no position has been reported.

Current mission state

GET /v1/orgs/{org_id}/fleets/{fleet_id}/robots/{robot_id}/mission

Returns the robot's live mission and operation state.

Response:

{
  "robot_id": "a1b2…",
  "current_operation_ref": "op-uuid",
  "current_mission_ref": "mission-uuid",
  "mission_state": "running",
  "mission_progress_pct": 42.0,
  "current_step": 3,
  "total_steps": 7,
  "mission_name": "Morning sweep"
}

Fields are null when the robot is not currently running a mission. current_operation_ref resolves through the operations endpoints; mission run history is under missions.

Health

A robot's health summary (fault, e-stop, mode, battery, fuel, range) is included in the robot detail response. See Get one robot.

Real-time streaming

The REST endpoints above return point-in-time snapshots. For continuous, live telemetry, Rover Nexus delivers updates over a real-time streaming channel instead of REST polling. To stream live telemetry today, use the Zenoh messaging surface or the ROS 2 bridge.