API

Live socket

The same stream the console draws from, for your own application.

Connect to wss://<host>/ws/live?access_token=<token>. The connection is pinned to the tenant in the token; you never see another tenant's vehicles.

Frames

The first frame is a snapshot:

{ "type": "snapshot", "vehicles": [
  { "vehicleId": "…", "vehicleLabel": "Van 3", "status": "MOVING",
    "lat": "27.1953", "lon": "31.1779", "speedKmh": "42", "headingDeg": "303",
    "imei": "…", "protocol": "gt06", "deviceTime": "2026-09-14T09:48:40Z" }
] }

Every later frame is one enriched position:

{ "type": "position", "event": {
  "vehicleId": "…", "vehicleLabel": "Van 3", "status": "MOVING",
  "telemetry": { "imei": "…", "protocol": "gt06", "deviceTime": "…",
                 "latitude": 27.1953, "longitude": 31.1779, "speedKmh": 42, "headingDeg": 303 }
} }

status is one of MOVING, IDLING, STOPPED, NO_FIX.

Behaviour to expect

Reconnect with backoff; the snapshot on reconnect makes the client correct again immediately.
A vehicle that stops reporting sends no "gone" frame; treat two minutes without an update as stale, as the console does.
Tokens expire; refresh and reconnect with the new one.

← Endpoints