Alerts

GET /fleet/alerts

Alerts raised by the organisation's alert rules: overspeeding, geofence entry and exit, harsh driving, idling, fatigue and others. Newest first.

Query parameters

Name	Type	Description
from	ISO-8601 time	Range start. Defaults to 24 hours before to.
to	ISO-8601 time	Range end. Defaults to now. At most 31 days after from.
type	string	Comma-separated event types (see below).
vehicleId	string	One vehicle only.
limit, cursor		See Pagination.

Event types

OVERSPEED, GEOFENCE_ENTER, GEOFENCE_EXIT, IGNITION_ON, IGNITION_OFF, LOCK, UNLOCK, HARSH_ACCELERATION, HARSH_BRAKING, SEVERE_ACCELERATION, SEVERE_BRAKING, FATIGUE, IDLE, ROUTE_DEVIATION

An event is only produced when the organisation has an active alert rule of that type.

Example

curl "https://api.routetracks.com/api/v1/partner/v1/fleet/alerts?type=OVERSPEED,GEOFENCE_ENTER&from=2026-10-22T00:00:00Z&to=2026-10-23T00:00:00Z" \
  -H "Authorization: Bearer $TOKEN"

{
  "data": [
    {
      "id": "cm2evt0912",
      "type": "OVERSPEED",
      "triggeredAt": "2026-10-22T09:41:17.000Z",
      "vehicleId": "cm1veh0003",
      "licensePlate": "WP CAB-1234",
      "driver": { "id": "cm1drv0007", "name": "Nimal Perera" },
      "rule": { "id": "cm1rul0002", "name": "Highway > 90 km/h" },
      "latitude": 7.01455,
      "longitude": 79.95932,
      "speedKmh": 97,
      "speedLimitKmh": 90,
      "durationSeconds": null,
      "zoneName": null
    },
    {
      "id": "cm2evt0907",
      "type": "GEOFENCE_ENTER",
      "triggeredAt": "2026-10-22T08:03:55.000Z",
      "vehicleId": "cm1veh0009",
      "licensePlate": "WP LM-9081",
      "driver": null,
      "rule": { "id": "cm1rul0005", "name": "Port arrivals" },
      "latitude": 6.94732,
      "longitude": 79.84391,
      "speedKmh": null,
      "speedLimitKmh": null,
      "durationSeconds": null,
      "zoneName": "Colombo Port – Gate 4"
    }
  ],
  "meta": {
    "limit": 100,
    "hasMore": false,
    "nextCursor": null,
    "from": "2026-10-22T00:00:00.000Z",
    "to": "2026-10-23T00:00:00.000Z"
  }
}

Fields

Field	Description
rule	The alert rule that fired.
driver	Driver assigned to the vehicle at triggeredAt, or null.
latitude, longitude	Where it happened, when known.
speedKmh, speedLimitKmh	Measured speed and the rule's limit (overspeed events).
durationSeconds	How long the condition lasted (for example idle or fatigue), when known.
zoneName	Geofence or route name for zone events.