--- title: "[beta] List tachograph live data" method: GET path: "/fleet/tachograph-live-data/latest" tags: ["Beta APIs"] --- # \[beta\] List tachograph live data `GET /fleet/tachograph-live-data/latest` ## Request - Base URL: `https://api.samsara.com` - URL: `https://api.samsara.com/fleet/tachograph-live-data/latest` - Auth: HTTP bearer Returns the latest live tachograph data for drivers, including working state and driving rest times, sourced from real-time telemetry. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Tachograph (EU)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. ## Query parameters - `driverIds` string - `vehicleIds` string - `startTime` string - `after` string - `limit` integer ## Response `200` OK response. - EntityTachographLiveDataRecordsServiceListTachographLiveDataResponseBody - `data` EntityListTachographLiveDataTypeResponseBody[], required: An array of TachographLiveDataRecords - `cumulatedDrivingTimePreviousAndCurrentWeekMinute` integer: The driver's cumulated driving time across the previous and current week, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `cumulativeBreakTimeMinute` integer: The driver's cumulative break time, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `currentDailyDrivingTimeMinute` integer: The driver's current daily driving time, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `currentDurationOfSelectedActivityMinute` integer: The duration of the driver's currently selected activity, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `currentWeeklyDrivingTimeMinute` integer: The driver's current weekly driving time, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `driverId` string: Samsara ID for the driver. - `durationOfNextBreakRestMinute` integer: The expected duration of the driver's next break or rest period, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `durationOfNextDrivingPeriodMinute` integer: The expected duration of the driver's next driving period, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `endOfLastDailyRestPeriod` string: The timestamp marking the end of the driver's last daily rest period, as defined by ISO 16844-7 (Tachograph - Digital data interface). - `endOfLastWeeklyRestPeriod` string: The timestamp marking the end of the driver's last weekly rest period, as defined by ISO 16844-7 (Tachograph - Digital data interface). - `happenedAtTime` string: The timestamp when the tachograph reading was measured. - `maximumDailyDrivingTimeMinute` integer: The maximum allowed daily driving time for the driver, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `minimumDailyRestMinute` integer: The minimum required daily rest duration for the driver, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `minimumWeeklyRestMinute` integer: The minimum required weekly rest duration for the driver, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `numberOfTimes9hDailyDrivingTimesExceeded` integer: The number of times the driver has exceeded the 9-hour daily driving time limit, as defined by ISO 16844-7 (Tachograph - Digital data interface). - `numberOfUsedReducedDailyRestPeriods` integer: The number of reduced daily rest periods the driver has used, as defined by ISO 16844-7 (Tachograph - Digital data interface). - `openCompensationInSecondWeekBeforeLastMinute` integer: Open rest compensation owed from the second week before last, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `openCompensationInTheLastWeekMinute` integer: Open rest compensation owed from the last week, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `openCompensationInWeekBeforeLastMinute` integer: Open rest compensation owed from the week before last, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `remaining2WeeksDrivingTimeMinute` integer: The driver's remaining driving time across the current two-week period, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `remainingCurrentDrivingTimeMinute` integer: The driver's remaining current continuous driving time before a break is required, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `remainingDrivingTimeOfCurrentWeekMinute` integer: The driver's remaining driving time for the current week, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `remainingDrivingTimeOnCurrentShiftMinute` integer: The driver's remaining driving time on the current shift, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `remainingTimeOfCurrentBreakRestMinute` integer: Time remaining in the driver's current break or rest period, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `remainingTimeUntilNextBreakOrRestMinute` integer: Time remaining until the driver's next required break or rest period, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `tachographCardNumber` string: The tachograph card number for the driver. - `timeLeftUntilNewDailyRestPeriodMinute` integer: Time remaining until the driver must begin a new daily rest period, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `timeLeftUntilNewWeeklyRestPeriodMinute` integer: Time remaining until the driver must begin a new weekly rest period, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `timeLeftUntilNextDrivingPeriodMinute` integer: Time remaining until the driver's next driving period can begin, as defined by ISO 16844-7 (Tachograph - Digital data interface). Measured in minutes. - `vehicleId` string: Samsara ID for the vehicle associated with the live tachograph data. - `workingState` string: The current working state of the driver (e.g. Rest, Availability, Work, Driving), as defined by ISO 16844-7 (Tachograph - Digital data interface). - `pagination` GoaPaginationResponseResponseBody, required: Pagination parameters. - `endCursor` string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view. - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor. ## Other responses - `401`: Unauthorized response. - `404`: Not Found response. - `405`: Method Not Allowed response. - `413`: Content Too Large response. - `429`: Too Many Requests response. - `500`: Internal Server Error response. - `501`: Not Implemented response. - `502`: Bad Gateway response. - `503`: Service Unavailable response. - `504`: Gateway Timeout response. - `default`: Bad Request response. --- [API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)