Driver scores

GET /fleet/driver-scores

Driver scores from 0 to 100 in three areas, plus an overall score. They are calculated daily from the incidents detected for each driver.

Query parameters

Use either date, or from and to:

Name	Type	Description
date	YYYY-MM-DD	Each driver's score snapshot for that day.
from, to	YYYY-MM-DD	Each driver's average over the range (at most 90 days).
driverId	string	One driver only.
limit, cursor		See Pagination.

With no dates, you get the average over the last 30 days.

Ordering:

• Single-day results are sorted by date, newest first.
• Range results are sorted by overall, highest first.

Example: one day

curl "https://api.routetracks.com/api/v1/partner/v1/fleet/driver-scores?date=2026-10-22" \
  -H "Authorization: Bearer $TOKEN"

{
  "data": [
    {
      "driverId": "cm1drv0007",
      "driverName": "Nimal Perera",
      "date": "2026-10-22",
      "snapshotCount": null,
      "safety": 88,
      "compliance": 95,
      "efficiency": 79,
      "overall": 87
    }
  ],
  "meta": {
    "mode": "day",
    "date": "2026-10-22",
    "from": null,
    "to": null,
    "limit": 100,
    "hasMore": false,
    "nextCursor": null
  }
}

Example: range average

curl "https://api.routetracks.com/api/v1/partner/v1/fleet/driver-scores?from=2026-10-01&to=2026-10-22" \
  -H "Authorization: Bearer $TOKEN"

{
  "data": [
    {
      "driverId": "cm1drv0007",
      "driverName": "Nimal Perera",
      "date": null,
      "snapshotCount": 22,
      "safety": 86.4,
      "compliance": 93.1,
      "efficiency": 80.2,
      "overall": 86.6
    }
  ],
  "meta": {
    "mode": "range",
    "date": null,
    "from": "2026-10-01",
    "to": "2026-10-22",
    "limit": 100,
    "hasMore": false,
    "nextCursor": null
  }
}

How scores are calculated

Each area starts at 100. Each incident subtracts points from its area, and the result is kept between 0 and 100.

Field	Incidents (points subtracted)
safety	Speeding (2), harsh braking (3), harsh acceleration (3), sharp cornering (2)
compliance	Fatigue (10), overtime (10)
efficiency	Excessive idling (1)
overall	Average of the three areas.