Geotab Developers

Introduction

A TripClassificationLog records how a trip is classified (business, private, commute, or mixed) for Keurmerk/SKRRS logbook reporting. It covers two cases: a classification override applied to an existing GPS Trip (TripClassificationLog.tripId is set) and a manually entered trip that fills a gap in the GPS record (TripClassificationLog.tripId is null).

Records use a soft-delete and edit-chain design. Editing a log inserts a new record whose TripClassificationLog.parentId points at the superseded record; the active record is the un-deleted leaf of the chain. An edit may revise the classification payload (TripClassificationLog.classification, the km splits, TripClassificationLog.destination, TripClassificationLog.businessPurpose, and TripClassificationLog.comment) and records the editing TripClassificationLog.classifiedByUser and TripClassificationLog.dateTime; the device, driver, trip identity, start and stop times, and odometer readings are immutable. Removing a log sets its deleted date rather than deleting the row.

**Important Note on Date Range Searches:** When you search using a fromDate and toDate, the API filters on TripClassificationLog.startDateTime (the trip start), returning logs whose trip started within the specified time frame.

Properties

The business distance of the trip in kilometres. Only set when TripClassificationLog.classification is Mixed.

The business purpose of the trip.

The TripClassificationType applied to the trip.

The User who classified the trip.

A free-text comment.

The commute distance of the trip in kilometres. Only set when TripClassificationLog.classification is Mixed.

The date and time the trip was classified.

The date and time the record was soft-deleted. null for an active record.

The trip destination.

The Device that made the trip.

The User whose trip is classified.

The Id of the GPS trip immediately following a manual trip.

The unique identifier for the specific Entity object in the Geotab system. See Id.

The odometer reading in metres at the end of the trip.

The Id of the record this record supersedes. null for the original record in an edit chain.

The Id of the GPS trip immediately preceding a manual trip.

The private distance of the trip in kilometres. Only set when TripClassificationLog.classification is Mixed.

The trip start date and time. This is the natural key used to match a classification to its GPS Trip; the read-time masking join is an exact (Device, StartDateTime) equality, so this value must round-trip with zero precision loss and must never be rounded or truncated.

The odometer reading in metres at the start of the trip.

The trip stop date and time.

The Id of the GPS Trip this log classifies. Set for a GPS-trip override, null for a manually entered trip. This is a supplementary audit reference only and is not the key used to look up the classification for a trip.

The version of the entity.

Rate limits

Method	Description	Limit	Period	Status
Get	Limit of 100 Get requests per 1m.	100	1m	Inactive
Set	Limit of 100 Set requests per 1m.	100	1m	Inactive
Add	Limit of 100 Add requests per 1m.	100	1m	Inactive
Remove	Limit of 100 Remove requests per 1m.	100	1m	Inactive
GetCountOf	Limit of 100 GetCountOf requests per 1m.	100	1m	Inactive
GetFeed	Limit of 60 GetFeed requests per 1m.	60	1m	Active

Pagination

Results limit

50000

Supported sort

Date sorts by the TripClassificationLog.DateTime property.

Version

Timeout Limit

Method	Description	Limit	Status
GetFeed		180	Active

Loading API Runner...

businessKm

businessPurpose

classification

classifiedByUser

comment

commuteKm

dateTime

deletedDateTime

destination

device

driver

followingTripId

id

odometer

parentId

precedingTripId

privateKm

startDateTime

startOdometer

stopDateTime

tripId

version