Skip to content

Daily summary ​

GET /fleet/daily-summary

Kilometres, number of trips, driving time and idle time per vehicle for one calendar day in the organisation's time zone. Use it for any past day or for today so far.

Query parameters ​

NameTypeDescription
dateYYYY-MM-DDThe day. Defaults to today.
vehicleIdstringOne vehicle only (not paginated).
limit, cursorSee Pagination. Pages are over vehicles.

For a date range, call once per day. Results for a past day don't change, so you can store them.

Example ​

bash
curl "https://api.routetracks.com/api/v1/partner/v1/fleet/daily-summary?date=2026-10-22" \
  -H "Authorization: Bearer $TOKEN"
json
{
  "data": [
    {
      "vehicleId": "cm1veh0003",
      "licensePlate": "WP CAB-1234",
      "date": "2026-10-22",
      "distanceKm": 152.4,
      "tripCount": 6,
      "drivingSeconds": 15420,
      "idleSeconds": 1860,
      "firstTripStart": "2026-10-22T01:12:44.000Z",
      "lastTripEnd": "2026-10-22T12:48:03.000Z",
      "departureArea": "Peliyagoda, Colombo",
      "endingArea": "Kandy"
    },
    {
      "vehicleId": "cm1veh0004",
      "licensePlate": "WP CAB-5678",
      "date": "2026-10-22",
      "distanceKm": 0,
      "tripCount": 0,
      "drivingSeconds": 0,
      "idleSeconds": 0,
      "firstTripStart": null,
      "lastTripEnd": null,
      "departureArea": null,
      "endingArea": null
    }
  ],
  "meta": {
    "date": "2026-10-22",
    "timezone": "Asia/Colombo",
    "from": "2026-10-21T18:30:00.000Z",
    "to": "2026-10-22T18:30:00.000Z",
    "limit": 100,
    "hasMore": false,
    "nextCursor": null
  }
}

Fields ​

FieldDescription
distanceKmDistance of trips that started on this day.
tripCountNumber of trips that started on this day.
drivingSecondsSummed duration of those trips.
idleSecondsTime with the engine on while stationary, within this day.
firstTripStart / departureAreaStart time and place of the first trip.
lastTripEnd / endingAreaEnd time and place of the last trip. It may fall after midnight.
meta.from / meta.toThe exact UTC window of the organisation-local day.

A trip that crosses midnight is counted in full on the day it started.

Partner API v1