Skip to main content
POST
/
bvfm
/
services
/
public
/
v1
/
customer
/
{customerId}
/
tacho
/
live
Tacho Live
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
    }
  ]
}

Authorizations

Authorization
string
header
required

Authorization header containing a Bearer token of the form Bearer [token], where [token] is a JWT used to authorize the request

Path Parameters

customerId
string
required

Body

application/json
driverKeys
string[]

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

registrations
string[]

MUST be identical to the vehicle registration registered with Connect.

skip
integer

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
integer

Limit the number of records to return in the response.

sort
object

The object contains direction and field path to sort. Sets the sort order to be either ascending (ASC) or descending (DESC).

Response

200 response

count
integer
required

Total number of records found

data
object[]
required

List of driver's current tacho status and cumulated time