GPS Telemetry Ingestion

Push rider location metrics in real-time to compute dynamic route ETAs.

POST

Ingest a rider GPS sample (latitude, longitude, accuracy, battery level) for an active in-transit dispatch. Also updates the rider's last-known position.

Authentication: Rider JWT

Request Body Fields

Field	Type	Requirement	Description
shipment	string (uuid)	Optional	Active Shipment UUID this sample belongs to.
latitude	decimal	Required	Current GPS latitude (-90 to +90).
longitude	decimal	Required	Current GPS longitude (-180 to +180).
accuracy	decimal	Optional	Reported GPS accuracy in meters.
battery_level	integer	Optional	Device battery percentage.

Request ExampleHTTPS Live Endpoint

curl -X POST https://api.tumr.app/api/v1/telemetry/ \
  -H "Authorization: Bearer RIDER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "shipment": "76495b28-1004-4b52-9fe1-d64e8e5ab190",
    "latitude": 6.5412,
    "longitude": 3.3645,
    "accuracy": 8.0,
    "battery_level": 76
  }'

Response Payload

201 Created

application/json

{
  "rider": "76495b28-1004-4b52-9fe1-d64e8e5ab190",
  "shipment": "76495b28-1004-4b52-9fe1-d64e8e5ab190",
  "latitude": "6.541200",
  "longitude": "3.364500",
  "accuracy": 8.0,
  "battery_level": 76.0,
  "timestamp": "2026-08-14T11:02:41Z"
}

Previous TopicWallet, Escrow & Settlements

Next TopicMerchant Analytics