Streaming

get_events stream

An event-summary record is pushed to the client's Kinesis stream whenever a new event is ingested for a unit.

Record envelope

Each Kinesis record's Data field is a base64-encoded JSON envelope. For this stream apiName is latest_event_summary_update.

{
  "clientId": "numaris",
  "apiName": "latest_event_summary_update",
  "eventLatency": "int",
  "payload": {
    "event_type_id": "33",
    "event_type_description": "Ignition off",
    "event_category": "1",
    "event_category_description": "Engine",
    "vehicle_id": "555",
    "unit_id": "98765",
    "license_number": "AB-123-CD",
    "chassis_number": "3HSDJAPR8JN000000",
    "drive_id": "660912",
    "time": "2026-06-24T08:14:55Z",
    "driver_id": "7788",
    "driver_name": "Juan Pérez",
    "worker_id": "EMP-3391",
    "driver_number": "104",
    "longitude": "34.7818",
    "latitude": "32.0853",
    "direction": "180",
    "speed": "0",
    "mileage": "152340",
    "client_id": "13648",
    "client_name": "Traxion Carga"
  }
}

Partition key

The Kinesis partition key for every record is "<unitType>:<innerId>", for example 1:905003453. All records for the same physical unit land on the same shard, preserving per-unit ordering.

Payload fields

Name	Type	Required	Description
`event_type_id`	string	required	Numeric event type identifier.
`event_type_description`	string	required	Human-readable event type label.
`event_category`	string	required	Numeric event category identifier.
`event_category_description`	string	required	Human-readable event category label.
`vehicle_id`	string	required	Internal vehicle identifier.
`unit_id`	string	required	Telematics unit identifier.
`license_number`	string	required	Vehicle license plate number.
`chassis_number`	string	required	VIN / chassis serial number.
`drive_id`	string	required	Active trip/drive identifier at event time.
`time`	string	required	Event timestamp (ISO 8601).
`driver_id`	string	required	Active driver identifier at event time.
`driver_name`	string	required	Active driver's display name.
`worker_id`	string	required	Active driver's worker/employee identifier.
`driver_number`	string	required	Active driver code / badge number.
`longitude`	string	required	GPS longitude at event time.
`latitude`	string	required	GPS latitude at event time.
`direction`	string	required	Heading in degrees (0–359) at event time.
`speed`	string	required	Speed at event time.
`mileage`	string	required	Odometer reading at event time.
`client_id`	string	required	Tenant/client identifier.
`client_name`	string	required	Tenant/client display name.