curl --request POST \
--url https://public-api.masternautconnect.com/bvfm/services/public/v1/customer/{customerId}/tacho/live \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"driverKeys": [
"<string>"
],
"registrations": [
"<string>"
],
"skip": 123,
"limit": 123,
"sort": {
"driverId": "<string>",
"driverKey": "<string>",
"driverName": "<string>",
"assetId": "<string>",
"assetRegistration": "<string>",
"eventDateTime": "<string>",
"lastUpdateTime": "<string>",
"heading": "<string>",
"latitude": "<string>",
"longitude": "<string>",
"address": "<string>",
"tachoMakeVersion": "<string>",
"activity": "<string>",
"infringementState": "<string>",
"currentActivityTotalTime": "<string>",
"continuousDrivingTime": "<string>",
"dailyDrivingTime": "<string>",
"weeklyDrivingTime": "<string>",
"previousAndCurrentTotalDriveTime": "<string>",
"remainingDrivingTime": "<string>",
"remainingDailyDrivingTime": "<string>",
"remainingWeeklyDrivingTime": "<string>",
"timeLeftUntilNextDailyRest": "<string>",
"nextDailyRestMinDuration": "<string>",
"timeLeftUntilNextWeeklyRest": "<string>",
"nextWeeklyRestMinDuration": "<string>",
"lastDailyRestEnd": "<string>",
"lastWeeklyRestEnd": "<string>",
"remainingDailyExtendedDriveTimePeriods": "<string>",
"remainingDailyShortenedRestTimePeriods": "<string>",
"workingTimeSinceLastBreak": "<string>",
"remainingWorkingTime": "<string>",
"dailyWorkingTime": "<string>",
"remainingDailyWorkingTime": "<string>",
"weeklyWorkingTime": "<string>",
"remainingWeeklyWorkingTime": "<string>",
"dailyBreakTime": "<string>",
"drivingPrediction.activity": "<string>",
"drivingPrediction.duration": "<string>",
"workingPrediction.activity": "<string>",
"workingPrediction.duration": "<string>",
"driverCardExpiryDate": "<string>",
"driverCardNextMandatoryDownloadDate": "<string>",
"timeLeftUntilNextRestPeriod": "<string>",
"nextRestDuration": "<string>"
}
}
'{
"count": 123,
"data": [
{
"driverId": "<string>",
"driverKey": "<string>",
"driverName": "<string>",
"assetId": "<string>",
"assetRegistration": "<string>",
"eventDateTime": "<string>",
"lastUpdateTime": "<string>",
"heading": 123,
"latitude": 123,
"longitude": 123,
"address": "<string>",
"tachoMakeVersion": "<string>",
"activity": "<string>",
"infringementState": 123,
"currentActivityTotalTime": 123,
"continuousDrivingTime": 123,
"dailyDrivingTime": 123,
"weeklyDrivingTime": 123,
"previousAndCurrentTotalDriveTime": 123,
"remainingDrivingTime": 123,
"remainingDailyDrivingTime": 123,
"remainingWeeklyDrivingTime": 123,
"timeLeftUntilNextDailyRest": 123,
"nextDailyRestMinDuration": 123,
"timeLeftUntilNextWeeklyRest": 123,
"nextWeeklyRestMinDuration": 123,
"lastDailyRestEnd": "<string>",
"lastWeeklyRestEnd": "<string>",
"remainingDailyExtendedDriveTimePeriods": 123,
"remainingDailyShortenedRestTimePeriods": 123,
"workingTimeSinceLastBreak": 123,
"remainingWorkingTime": 123,
"dailyWorkingTime": 123,
"remainingDailyWorkingTime": 123,
"weeklyWorkingTime": 123,
"remainingWeeklyWorkingTime": 123,
"dailyBreakTime": 123,
"drivingPrediction": [
{
"activity": 123,
"duration": 123
}
],
"workingPrediction": [
{
"activity": 123,
"duration": 123
}
],
"driverCardExpiryDate": "<string>",
"driverCardNextMandatoryDownloadDate": "<string>",
"timeLeftUntilNextRestPeriod": 123,
"nextRestDuration": 123,
"timersQualityLevel": "<string>",
"remainingBiweeklyDrivingTime": 123,
"vehicleFriendlyName": "<string>",
"shiftStart": "<string>",
"shiftDueEnd": "<string>",
"weekDueEnd": "<string>",
"driverCardInserted": true,
"vehicleIgnitionOn": true,
"vehicleSpeed": 123,
"engineSpeed": 123,
"restCompensationPreviousWeek": 123,
"restCompensationSecondPreviousWeek": 123,
"restCompensationThirdPreviousWeek": 123,
"remainingTimeOfCurrentRest": 123,
"durationOfCurrentRest": 123,
"issuingMemberState": "<string>",
"driverFriendlyName": "<string>",
"driverCardSlot": 123
}
]
}This provides the latest known tachograph status and aggregated time counters for a set of drivers. It is designed to power real-time operational systems such as Transport Management Systems (TMS) or workforce productivity tools by supplying up-to-date driving, working, and rest times for active drivers.
This endpoint is not intended for historical reporting or data storage. To access past driver activities and compliance records, use the Tacho Activity endpoint instead.
curl --request POST \
--url https://public-api.masternautconnect.com/bvfm/services/public/v1/customer/{customerId}/tacho/live \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"driverKeys": [
"<string>"
],
"registrations": [
"<string>"
],
"skip": 123,
"limit": 123,
"sort": {
"driverId": "<string>",
"driverKey": "<string>",
"driverName": "<string>",
"assetId": "<string>",
"assetRegistration": "<string>",
"eventDateTime": "<string>",
"lastUpdateTime": "<string>",
"heading": "<string>",
"latitude": "<string>",
"longitude": "<string>",
"address": "<string>",
"tachoMakeVersion": "<string>",
"activity": "<string>",
"infringementState": "<string>",
"currentActivityTotalTime": "<string>",
"continuousDrivingTime": "<string>",
"dailyDrivingTime": "<string>",
"weeklyDrivingTime": "<string>",
"previousAndCurrentTotalDriveTime": "<string>",
"remainingDrivingTime": "<string>",
"remainingDailyDrivingTime": "<string>",
"remainingWeeklyDrivingTime": "<string>",
"timeLeftUntilNextDailyRest": "<string>",
"nextDailyRestMinDuration": "<string>",
"timeLeftUntilNextWeeklyRest": "<string>",
"nextWeeklyRestMinDuration": "<string>",
"lastDailyRestEnd": "<string>",
"lastWeeklyRestEnd": "<string>",
"remainingDailyExtendedDriveTimePeriods": "<string>",
"remainingDailyShortenedRestTimePeriods": "<string>",
"workingTimeSinceLastBreak": "<string>",
"remainingWorkingTime": "<string>",
"dailyWorkingTime": "<string>",
"remainingDailyWorkingTime": "<string>",
"weeklyWorkingTime": "<string>",
"remainingWeeklyWorkingTime": "<string>",
"dailyBreakTime": "<string>",
"drivingPrediction.activity": "<string>",
"drivingPrediction.duration": "<string>",
"workingPrediction.activity": "<string>",
"workingPrediction.duration": "<string>",
"driverCardExpiryDate": "<string>",
"driverCardNextMandatoryDownloadDate": "<string>",
"timeLeftUntilNextRestPeriod": "<string>",
"nextRestDuration": "<string>"
}
}
'{
"count": 123,
"data": [
{
"driverId": "<string>",
"driverKey": "<string>",
"driverName": "<string>",
"assetId": "<string>",
"assetRegistration": "<string>",
"eventDateTime": "<string>",
"lastUpdateTime": "<string>",
"heading": 123,
"latitude": 123,
"longitude": 123,
"address": "<string>",
"tachoMakeVersion": "<string>",
"activity": "<string>",
"infringementState": 123,
"currentActivityTotalTime": 123,
"continuousDrivingTime": 123,
"dailyDrivingTime": 123,
"weeklyDrivingTime": 123,
"previousAndCurrentTotalDriveTime": 123,
"remainingDrivingTime": 123,
"remainingDailyDrivingTime": 123,
"remainingWeeklyDrivingTime": 123,
"timeLeftUntilNextDailyRest": 123,
"nextDailyRestMinDuration": 123,
"timeLeftUntilNextWeeklyRest": 123,
"nextWeeklyRestMinDuration": 123,
"lastDailyRestEnd": "<string>",
"lastWeeklyRestEnd": "<string>",
"remainingDailyExtendedDriveTimePeriods": 123,
"remainingDailyShortenedRestTimePeriods": 123,
"workingTimeSinceLastBreak": 123,
"remainingWorkingTime": 123,
"dailyWorkingTime": 123,
"remainingDailyWorkingTime": 123,
"weeklyWorkingTime": 123,
"remainingWeeklyWorkingTime": 123,
"dailyBreakTime": 123,
"drivingPrediction": [
{
"activity": 123,
"duration": 123
}
],
"workingPrediction": [
{
"activity": 123,
"duration": 123
}
],
"driverCardExpiryDate": "<string>",
"driverCardNextMandatoryDownloadDate": "<string>",
"timeLeftUntilNextRestPeriod": 123,
"nextRestDuration": 123,
"timersQualityLevel": "<string>",
"remainingBiweeklyDrivingTime": 123,
"vehicleFriendlyName": "<string>",
"shiftStart": "<string>",
"shiftDueEnd": "<string>",
"weekDueEnd": "<string>",
"driverCardInserted": true,
"vehicleIgnitionOn": true,
"vehicleSpeed": 123,
"engineSpeed": 123,
"restCompensationPreviousWeek": 123,
"restCompensationSecondPreviousWeek": 123,
"restCompensationThirdPreviousWeek": 123,
"remainingTimeOfCurrentRest": 123,
"durationOfCurrentRest": 123,
"issuingMemberState": "<string>",
"driverFriendlyName": "<string>",
"driverCardSlot": 123
}
]
}Authorization header containing a Bearer token of the form Bearer [token], where [token] is a JWT used to authorize the request
MUST be identical to the full key unique 14 character chars and issue number. At least one parameter from this list must be provided: driverKeys, registrations, lastUpdatedSince
MUST be identical to the vehicle registration registered with Connect.
Number of records to be skipped before the beginning of the result set. This acts as an offset from the first record matching the request parameters.
Limit the number of records to return in the response.
The object contains direction and field path to sort. Sets the sort order to be either ascending (ASC) or descending (DESC).
Show child attributes
Was this page helpful?