FC HUB API
HUB GraphQL API documentation
Login token url: POST
https://api.fleetcomplete.com/login/token
Payload: username, password
Your token is value of 'access_token' in response
Get user id: GET
https://api.fleetcomplete.com/login/userinfo
(Bearer access_token is mandatory)
Response may contain multiple userIds, the user must choose the correct userId.
Getting started
getToken
request:
curl --location --request POST 'https://api.fleetcomplete.com/login/token' \
--form 'username="your username"' \
--form 'password="your password"'
response:
{"scope":"openid email profile","access_token":"eyJhbGciOiJSUzI1NiIsInR5cCI.......
access_token value should be used as 'Authorization' header in all the following requests
getUserId
request:
curl --location --request GET 'https://api.fleetcomplete.com/login/userinfo' \
--header 'Authorization: Bearer access_token from getToken response'
response:
[{"userName":"your username","userId":"your user id","fleetName":"your fleet name"}....
userId value should be used as 'userId' header in all the following requests
following requests
request:
curl --location --request POST 'https://api.fleetcomplete.com/graphql' \
--header 'Authorization: Bearer access_token from getToken response' \
--header 'userId: userId from getUserId response' \
--header 'Content-Type: application/json' \
--data-raw 'graphQL query and variables'
Headers tab in GraphQL IDE
Header:
{
"userId":"USER_UUID_GOES_HERE",
"Authorization":"Bearer USER_TOKEN_GOES_HERE"
}
Rate limiting
GraphQL API allows only one active request per user. Sending multiple simultaneous requests will result in an HTTP 429 Too Many Requests status code, indicating that the user has exceeded the permitted request limit. Please wait for the ongoing request to finish before attempting additional requests.
API Endpoints
# HUB GraphQL API endpoint:
https://api.fleetcomplete.com/graphql
# GraphQL IDE endpoint for fiddling with graphql queries:
https://api.fleetcomplete.com/graphiql?path=/graphql
# HUB API get token endpoint:
POST https://api.fleetcomplete.com/login/token
# Get HUB API userId value:
https://api.fleetcomplete.com/login/userinfo
Headers
# Mandatory
Authorization: Bearer <YOUR_TOKEN_HERE>
# Either userId or fleetId is mandatory
userId: <UUID>
fleetId: <UUID>
Queries
getDeviceById
Description
Get single Device record by ID
Example
Query
query GetDeviceById($id: UUID!) {
getDeviceById(id: $id) {
id
serial
deviceTypeKey
enabled
phoneNumber
}
}
Variables
{
"id": "daef229b-23db-4947-a472-3fbee2f43001"
}
Response
{
"data": {
"getDeviceById": {
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"serial": "abc123",
"deviceTypeKey": "abc123",
"enabled": true,
"phoneNumber": "abc123"
}
}
}
getDeviceBySerial
Description
Get single Device record by Serial
Example
Query
query GetDeviceBySerial($serial: String!) {
getDeviceBySerial(serial: $serial) {
id
serial
deviceTypeKey
enabled
phoneNumber
}
}
Variables
{"serial": "xyz789"}
Response
{
"data": {
"getDeviceBySerial": {
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"serial": "xyz789",
"deviceTypeKey": "xyz789",
"enabled": true,
"phoneNumber": "abc123"
}
}
}
getGeofenceById
Description
Get single Geofence record by ID
Example
Query
query GetGeofenceById($id: UUID!) {
getGeofenceById(id: $id) {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
geojson
color
phone
email
address {
country
countryCode
region
city
postalCode
address
}
description
}
}
Variables
{
"id": "daef229b-23db-4947-a472-3fbee2f43001"
}
Response
{
"data": {
"getGeofenceById": {
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": false,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"geojson": {},
"color": "abc123",
"phone": "xyz789",
"email": "xyz789",
"address": Address,
"description": "abc123"
}
}
}
getGeofences
Description
Get all Geofence records, visible to current user
Response
Returns
[Geofence]
Example
Query
query GetGeofences {
getGeofences {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
geojson
color
phone
email
address {
country
countryCode
region
city
postalCode
address
}
description
}
}
Response
{
"data": {
"getGeofences": [
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": true,
"name": "xyz789",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"geojson": {},
"color": "xyz789",
"phone": "abc123",
"email": "xyz789",
"address": Address,
"description": "xyz789"
}
]
}
}
getGroups
Description
Get all Group records, visible to current user
Response
Returns
[Group]
Example
Query
query GetGroups {
getGroups {
id
version
createdAt
updatedAt
name
fleetId
parentId
externalId
description
isOwn
vehicleIds
assignedVehicles {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
vin
licensePlate
make
model
year
latestData {
...LatestDataFragment
}
lastData {
...CommonFormatFragment
}
assignedGroups {
...GroupFragment
}
assignedDevices {
...DeviceFragment
}
assignedLabels {
...LabelFragment
}
lastOdometer
lastWorkingHours
deactivated
vehicleType {
...VehicleTypeFragment
}
customFields {
...CustomFieldFragment
}
workSchedule {
...WorkScheduleFragment
}
}
}
}
Response
{
"data": {
"getGroups": [
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"parentId": "daef229b-23db-4947-a472-3fbee2f43001",
"externalId": "xyz789",
"description": "xyz789",
"isOwn": false,
"vehicleIds": [
"daef229b-23db-4947-a472-3fbee2f43001"
],
"assignedVehicles": [Vehicle]
}
]
}
}
getLabels
Description
Get all Label records
Response
Returns
[Label]
Example
Query
query GetLabels {
getLabels {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
}
}
Response
{
"data": {
"getLabels": [
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": true,
"name": "xyz789",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001"
}
]
}
}
getLatestSnapshots
Description
Get latest snapshots for a list of vehicles
Response
Returns
[CommonFormat]
Arguments
Name | Description |
---|---|
vehicleIds -
[UUID!]!
|
Example
Query
query GetLatestSnapshots($vehicleIds: [UUID!]!) {
getLatestSnapshots(vehicleIds: $vehicleIds) {
vehicleId
vehicle {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
vin
licensePlate
make
model
year
latestData {
...LatestDataFragment
}
lastData {
...CommonFormatFragment
}
assignedGroups {
...GroupFragment
}
assignedDevices {
...DeviceFragment
}
assignedLabels {
...LabelFragment
}
lastOdometer
lastWorkingHours
deactivated
vehicleType {
...VehicleTypeFragment
}
customFields {
...CustomFieldFragment
}
workSchedule {
...WorkScheduleFragment
}
}
timestamp
gps {
state
latitude
longitude
direction
altitude
speed
satellites
hdop
}
ignition {
engineStatus
}
driver {
driverId
iButton
oneWire
rfidIButton
rfidIButtonHex
rfidIButtonReversed
rfidIButtonReversedHex
rfid
rfidHex
}
canBus {
absStatus
acceleratorPedalPosition
accelerationX
accelerationY
ambientAirTemperature
barometricPressure
brakeApplicationPressure
brakePedalPosition
brakePedalState
brakeTorque
canCombinationWeight
combinationWeight
canrpm
canDistance
canDeltaDistance
canTripDistance
canFuelUsed
canTripFuelUsed
canTripFuelUsedPercent
canServiceDistance
canFuelRate
canhrFuelUsed
canSpeed
canFuel
canRawFuel
canAxleNumber
canAxleWeight
canAxleWeights {
...CanAxleWeightsMapFragment
}
canEngineCoolantTemperature
canEngineHours
canFuelEconomy
canWheelSpeed
cargoWeight
checkEngineWarning
clutchPedalState
cruiseControlState
deltaFuelUsed
engineCoolantLevel
engineCoolantPressure
engineFuelType
engineOilLevel
engineOilPressure
engineOilTemperature
enginePercentLoad
engineRunTime
engineThrottlePosition
engineIdleTime
engineWorkTime
fuelDeliveryPressure
gear
intakeAirTemperature
massAirFlow
oilLifeRemaining
overweight
parkingBrakeSwitch
seatBeltDriver
seatBeltPassenger
seatOccupiedDriver
seatOccupiedPassenger
serviceNowWarning
tirePressureWarning
tirePressure {
...TirePressureMapFragment
}
tirePressureStatus {
...TirePressureStatusMapFragment
}
tirePressurePlacardFront
tirePressurePlacardRear
tireLocation
tractionControl
tractionControlBrake
tractionControlPowerTrain
transmissionOilTemperature
washerFluidLevel
waterInFuel
canFuelConsumption
frontLeftDoorOpen
frontRightDoorStatus
hoodOpen
rearLeftDoorOpen
rearRightDoorOpen
trunkOpen
canProgramNumber
cruiseControlActive
retarderTorqueMode
actualRetarderLevel
nonEngineRetarderSelectionLevel
}
driverBehaviour {
driverBehaviourType
driverBehaviourValue
}
temperatures {
temperatures {
...TemperatureMapFragment
}
temperatureSensorIds {
...TemperatureSensorMapFragment
}
}
fleetMetaSensors {
sensors {
...SensorMapFragment
}
}
fuel {
fuel
rawFuel {
...RawFuelMapFragment
}
pulseCount
fuelLevel {
...FuelLevelMapFragment
}
totalFuelEconomy
fuelTankSize
}
misc {
power
}
locationTimestamp
locationTimeZone
}
}
Variables
{
"vehicleIds": [
"daef229b-23db-4947-a472-3fbee2f43001"
]
}
Response
{
"data": {
"getLatestSnapshots": [
{
"vehicleId": "daef229b-23db-4947-a472-3fbee2f43001",
"vehicle": Vehicle,
"timestamp": "2007-12-03T10:15:30Z",
"gps": Gps,
"ignition": Ignition,
"driver": Driver,
"canBus": CanBus,
"driverBehaviour": DriverBehaviour,
"temperatures": Temperatures,
"fleetMetaSensors": FleetMetaSensors,
"fuel": Fuel,
"misc": Misc,
"locationTimestamp": "2007-12-03T10:15:30Z",
"locationTimeZone": "abc123"
}
]
}
}
getMetaSensors
Description
Get all MetaSensor records, visible to current user
Response
Returns
[MetaSensor]
Example
Query
query GetMetaSensors {
getMetaSensors {
name
key
}
}
Response
{
"data": {
"getMetaSensors": [
{"name": "abc123", "key": 123}
]
}
}
getPeople
Description
Get all Person records, visible to current user
Response
Returns
[Person]
Example
Query
query GetPeople {
getPeople {
id
version
createdAt
updatedAt
isDeleted
isUser
isDriver
fleetId
email
firstName
lastName
globalUserId
licenseNumber
licenseIssuedIn
employeeId
customFields {
name
value
}
}
}
Response
{
"data": {
"getPeople": [
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": true,
"isUser": false,
"isDriver": false,
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"email": "abc123",
"firstName": "xyz789",
"lastName": "abc123",
"globalUserId": "abc123",
"licenseNumber": "xyz789",
"licenseIssuedIn": "abc123",
"employeeId": "abc123",
"customFields": [CustomField]
}
]
}
}
getPersonById
Description
Get single Person record by ID
Example
Query
query GetPersonById($id: UUID!) {
getPersonById(id: $id) {
id
version
createdAt
updatedAt
isDeleted
isUser
isDriver
fleetId
email
firstName
lastName
globalUserId
licenseNumber
licenseIssuedIn
employeeId
customFields {
name
value
}
}
}
Variables
{
"id": "daef229b-23db-4947-a472-3fbee2f43001"
}
Response
{
"data": {
"getPersonById": {
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": true,
"isUser": true,
"isDriver": false,
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"email": "abc123",
"firstName": "abc123",
"lastName": "xyz789",
"globalUserId": "abc123",
"licenseNumber": "xyz789",
"licenseIssuedIn": "xyz789",
"employeeId": "xyz789",
"customFields": [CustomField]
}
}
}
getPersonCustomFields
Description
Get single Person custom fields by ID
Response
Returns
[CustomField]
Arguments
Name | Description |
---|---|
personId -
UUID!
|
Example
Query
query GetPersonCustomFields($personId: UUID!) {
getPersonCustomFields(personId: $personId) {
name
value
}
}
Variables
{
"personId": "daef229b-23db-4947-a472-3fbee2f43001"
}
Response
{
"data": {
"getPersonCustomFields": [
{
"name": "xyz789",
"value": "abc123"
}
]
}
}
getRules
Description
Get all event rules
Response
Returns
[Rule]
Example
Query
query GetRules {
getRules {
id
name
enabled
ruleType
vehicles {
assignedVehicleIds
assignedGroupIds
assignedToAll
}
geofenceIds
}
}
Response
{
"data": {
"getRules": [
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"name": "xyz789",
"enabled": false,
"ruleType": "abc123",
"vehicles": RuleVehicles,
"geofenceIds": [
"daef229b-23db-4947-a472-3fbee2f43001"
]
}
]
}
}
getSnapshots
Description
Get vehicle snapshots by a period of time in parameters
Response
Returns
[CommonFormat]
Example
Query
query GetSnapshots(
$vehicleId: UUID!,
$from: DateTime!,
$to: DateTime!
) {
getSnapshots(
vehicleId: $vehicleId,
from: $from,
to: $to
) {
vehicleId
vehicle {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
vin
licensePlate
make
model
year
latestData {
...LatestDataFragment
}
lastData {
...CommonFormatFragment
}
assignedGroups {
...GroupFragment
}
assignedDevices {
...DeviceFragment
}
assignedLabels {
...LabelFragment
}
lastOdometer
lastWorkingHours
deactivated
vehicleType {
...VehicleTypeFragment
}
customFields {
...CustomFieldFragment
}
workSchedule {
...WorkScheduleFragment
}
}
timestamp
gps {
state
latitude
longitude
direction
altitude
speed
satellites
hdop
}
ignition {
engineStatus
}
driver {
driverId
iButton
oneWire
rfidIButton
rfidIButtonHex
rfidIButtonReversed
rfidIButtonReversedHex
rfid
rfidHex
}
canBus {
absStatus
acceleratorPedalPosition
accelerationX
accelerationY
ambientAirTemperature
barometricPressure
brakeApplicationPressure
brakePedalPosition
brakePedalState
brakeTorque
canCombinationWeight
combinationWeight
canrpm
canDistance
canDeltaDistance
canTripDistance
canFuelUsed
canTripFuelUsed
canTripFuelUsedPercent
canServiceDistance
canFuelRate
canhrFuelUsed
canSpeed
canFuel
canRawFuel
canAxleNumber
canAxleWeight
canAxleWeights {
...CanAxleWeightsMapFragment
}
canEngineCoolantTemperature
canEngineHours
canFuelEconomy
canWheelSpeed
cargoWeight
checkEngineWarning
clutchPedalState
cruiseControlState
deltaFuelUsed
engineCoolantLevel
engineCoolantPressure
engineFuelType
engineOilLevel
engineOilPressure
engineOilTemperature
enginePercentLoad
engineRunTime
engineThrottlePosition
engineIdleTime
engineWorkTime
fuelDeliveryPressure
gear
intakeAirTemperature
massAirFlow
oilLifeRemaining
overweight
parkingBrakeSwitch
seatBeltDriver
seatBeltPassenger
seatOccupiedDriver
seatOccupiedPassenger
serviceNowWarning
tirePressureWarning
tirePressure {
...TirePressureMapFragment
}
tirePressureStatus {
...TirePressureStatusMapFragment
}
tirePressurePlacardFront
tirePressurePlacardRear
tireLocation
tractionControl
tractionControlBrake
tractionControlPowerTrain
transmissionOilTemperature
washerFluidLevel
waterInFuel
canFuelConsumption
frontLeftDoorOpen
frontRightDoorStatus
hoodOpen
rearLeftDoorOpen
rearRightDoorOpen
trunkOpen
canProgramNumber
cruiseControlActive
retarderTorqueMode
actualRetarderLevel
nonEngineRetarderSelectionLevel
}
driverBehaviour {
driverBehaviourType
driverBehaviourValue
}
temperatures {
temperatures {
...TemperatureMapFragment
}
temperatureSensorIds {
...TemperatureSensorMapFragment
}
}
fleetMetaSensors {
sensors {
...SensorMapFragment
}
}
fuel {
fuel
rawFuel {
...RawFuelMapFragment
}
pulseCount
fuelLevel {
...FuelLevelMapFragment
}
totalFuelEconomy
fuelTankSize
}
misc {
power
}
locationTimestamp
locationTimeZone
}
}
Variables
{
"vehicleId": "daef229b-23db-4947-a472-3fbee2f43001",
"from": "2007-12-03T10:15:30Z",
"to": "2007-12-03T10:15:30Z"
}
Response
{
"data": {
"getSnapshots": [
{
"vehicleId": "daef229b-23db-4947-a472-3fbee2f43001",
"vehicle": Vehicle,
"timestamp": "2007-12-03T10:15:30Z",
"gps": Gps,
"ignition": Ignition,
"driver": Driver,
"canBus": CanBus,
"driverBehaviour": DriverBehaviour,
"temperatures": Temperatures,
"fleetMetaSensors": FleetMetaSensors,
"fuel": Fuel,
"misc": Misc,
"locationTimestamp": "2007-12-03T10:15:30Z",
"locationTimeZone": "xyz789"
}
]
}
}
getUserInfo
Description
Get FleetUserInfo records visible to user currently logged in
Response
Returns
[FleetUserInfo]
Example
Query
query GetUserInfo {
getUserInfo {
userName
userId
fleetName
fleetId
}
}
Response
{
"data": {
"getUserInfo": [
{
"userName": "abc123",
"userId": "xyz789",
"fleetName": "abc123",
"fleetId": "abc123"
}
]
}
}
getVehicleById
Description
Get single Vehicle record by ID
Example
Query
query GetVehicleById($id: UUID!) {
getVehicleById(id: $id) {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
vin
licensePlate
make
model
year
latestData {
timestamp
gps {
...GpsFragment
}
gpsWithTimestamp {
...GpsWithTimestampFragment
}
odometer {
...FloatWithTimestampFragment
}
workingHours {
...FloatWithTimestampFragment
}
address {
...AddressFragment
}
speedLimit {
...SpeedLimitFragment
}
geofenceData {
...GeofenceDataFragment
}
metaSensorData {
...SensorDataFragment
}
ptoHoursData {
...LongWithTimestampFragment
}
driverData {
...DriverDataFragment
}
canBus {
...CanBusFragment
}
canBusWithTimestamp {
...CanBusWithTimestampFragment
}
ignition {
...IgnitionFragment
}
ignitionWithTimestamp {
...IgnitionWithTimestampFragment
}
driverBehaviour {
...DriverBehaviourFragment
}
driverBehaviourWithTimestamp {
...DriverBehaviourWithTimestampFragment
}
temperatures {
...TemperaturesFragment
}
temperaturesWithTimestamp {
...TemperaturesWithTimestampFragment
}
fuel {
...FuelFragment
}
fuelWithTimestamp {
...FuelWithTimestampFragment
}
misc {
...MiscFragment
}
miscWithTimestamp {
...MiscWithTimestampFragment
}
crash {
...CrashFragment
}
crashWithTimestamp {
...CrashWithTimestampFragment
}
}
lastData {
vehicleId
vehicle {
...VehicleFragment
}
timestamp
gps {
...GpsFragment
}
ignition {
...IgnitionFragment
}
driver {
...DriverFragment
}
canBus {
...CanBusFragment
}
driverBehaviour {
...DriverBehaviourFragment
}
temperatures {
...TemperaturesFragment
}
fleetMetaSensors {
...FleetMetaSensorsFragment
}
fuel {
...FuelFragment
}
misc {
...MiscFragment
}
locationTimestamp
locationTimeZone
}
assignedGroups {
id
version
createdAt
updatedAt
name
fleetId
parentId
externalId
description
isOwn
vehicleIds
assignedVehicles {
...VehicleFragment
}
}
assignedDevices {
id
serial
deviceTypeKey
enabled
phoneNumber
}
assignedLabels {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
}
lastOdometer
lastWorkingHours
deactivated
vehicleType {
id
name
}
customFields {
name
value
}
workSchedule {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
isDefault
beginGrace
endGrace
periods {
...WorkSchedulePeriodFragment
}
}
}
}
Variables
{
"id": "daef229b-23db-4947-a472-3fbee2f43001"
}
Response
{
"data": {
"getVehicleById": {
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": false,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"vin": "xyz789",
"licensePlate": "xyz789",
"make": "xyz789",
"model": "abc123",
"year": 123,
"latestData": LatestData,
"lastData": CommonFormat,
"assignedGroups": [Group],
"assignedDevices": [Device],
"assignedLabels": [Label],
"lastOdometer": 987.65,
"lastWorkingHours": 987.65,
"deactivated": false,
"vehicleType": VehicleType,
"customFields": [CustomField],
"workSchedule": WorkSchedule
}
}
}
getVehicleCustomFields
Description
Get all CustomField records, mapped to vehicle
Response
Returns
[CustomField]
Arguments
Name | Description |
---|---|
vehicleId -
UUID!
|
Example
Query
query GetVehicleCustomFields($vehicleId: UUID!) {
getVehicleCustomFields(vehicleId: $vehicleId) {
name
value
}
}
Variables
{
"vehicleId": "daef229b-23db-4947-a472-3fbee2f43001"
}
Response
{
"data": {
"getVehicleCustomFields": [
{
"name": "abc123",
"value": "abc123"
}
]
}
}
getVehicleMappedSensors
Description
Get all MetaSensor records, mapped to vehicle
Example
Query
query GetVehicleMappedSensors($vehicleId: UUID!) {
getVehicleMappedSensors(vehicleId: $vehicleId) {
name
source
}
}
Variables
{
"vehicleId": "daef229b-23db-4947-a472-3fbee2f43001"
}
Response
{
"data": {
"getVehicleMappedSensors": [
{
"name": "xyz789",
"source": "abc123"
}
]
}
}
getVehicleTypes
Description
Get all VehicleType records
Response
Returns
[VehicleType]
Example
Query
query GetVehicleTypes {
getVehicleTypes {
id
name
}
}
Response
{
"data": {
"getVehicleTypes": [
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"name": "xyz789"
}
]
}
}
getVehicles
Description
Get all Vehicle records, visible to current user
Response
Returns
[Vehicle]
Example
Query
query GetVehicles {
getVehicles {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
vin
licensePlate
make
model
year
latestData {
timestamp
gps {
...GpsFragment
}
gpsWithTimestamp {
...GpsWithTimestampFragment
}
odometer {
...FloatWithTimestampFragment
}
workingHours {
...FloatWithTimestampFragment
}
address {
...AddressFragment
}
speedLimit {
...SpeedLimitFragment
}
geofenceData {
...GeofenceDataFragment
}
metaSensorData {
...SensorDataFragment
}
ptoHoursData {
...LongWithTimestampFragment
}
driverData {
...DriverDataFragment
}
canBus {
...CanBusFragment
}
canBusWithTimestamp {
...CanBusWithTimestampFragment
}
ignition {
...IgnitionFragment
}
ignitionWithTimestamp {
...IgnitionWithTimestampFragment
}
driverBehaviour {
...DriverBehaviourFragment
}
driverBehaviourWithTimestamp {
...DriverBehaviourWithTimestampFragment
}
temperatures {
...TemperaturesFragment
}
temperaturesWithTimestamp {
...TemperaturesWithTimestampFragment
}
fuel {
...FuelFragment
}
fuelWithTimestamp {
...FuelWithTimestampFragment
}
misc {
...MiscFragment
}
miscWithTimestamp {
...MiscWithTimestampFragment
}
crash {
...CrashFragment
}
crashWithTimestamp {
...CrashWithTimestampFragment
}
}
lastData {
vehicleId
vehicle {
...VehicleFragment
}
timestamp
gps {
...GpsFragment
}
ignition {
...IgnitionFragment
}
driver {
...DriverFragment
}
canBus {
...CanBusFragment
}
driverBehaviour {
...DriverBehaviourFragment
}
temperatures {
...TemperaturesFragment
}
fleetMetaSensors {
...FleetMetaSensorsFragment
}
fuel {
...FuelFragment
}
misc {
...MiscFragment
}
locationTimestamp
locationTimeZone
}
assignedGroups {
id
version
createdAt
updatedAt
name
fleetId
parentId
externalId
description
isOwn
vehicleIds
assignedVehicles {
...VehicleFragment
}
}
assignedDevices {
id
serial
deviceTypeKey
enabled
phoneNumber
}
assignedLabels {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
}
lastOdometer
lastWorkingHours
deactivated
vehicleType {
id
name
}
customFields {
name
value
}
workSchedule {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
isDefault
beginGrace
endGrace
periods {
...WorkSchedulePeriodFragment
}
}
}
}
Response
{
"data": {
"getVehicles": [
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": false,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"vin": "xyz789",
"licensePlate": "abc123",
"make": "abc123",
"model": "abc123",
"year": 987,
"latestData": LatestData,
"lastData": CommonFormat,
"assignedGroups": [Group],
"assignedDevices": [Device],
"assignedLabels": [Label],
"lastOdometer": 987.65,
"lastWorkingHours": 123.45,
"deactivated": false,
"vehicleType": VehicleType,
"customFields": [CustomField],
"workSchedule": WorkSchedule
}
]
}
}
getVehiclesByVin
Description
Get Vehicle records by VIN code
Example
Query
query GetVehiclesByVin($vin: String!) {
getVehiclesByVin(vin: $vin) {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
vin
licensePlate
make
model
year
latestData {
timestamp
gps {
...GpsFragment
}
gpsWithTimestamp {
...GpsWithTimestampFragment
}
odometer {
...FloatWithTimestampFragment
}
workingHours {
...FloatWithTimestampFragment
}
address {
...AddressFragment
}
speedLimit {
...SpeedLimitFragment
}
geofenceData {
...GeofenceDataFragment
}
metaSensorData {
...SensorDataFragment
}
ptoHoursData {
...LongWithTimestampFragment
}
driverData {
...DriverDataFragment
}
canBus {
...CanBusFragment
}
canBusWithTimestamp {
...CanBusWithTimestampFragment
}
ignition {
...IgnitionFragment
}
ignitionWithTimestamp {
...IgnitionWithTimestampFragment
}
driverBehaviour {
...DriverBehaviourFragment
}
driverBehaviourWithTimestamp {
...DriverBehaviourWithTimestampFragment
}
temperatures {
...TemperaturesFragment
}
temperaturesWithTimestamp {
...TemperaturesWithTimestampFragment
}
fuel {
...FuelFragment
}
fuelWithTimestamp {
...FuelWithTimestampFragment
}
misc {
...MiscFragment
}
miscWithTimestamp {
...MiscWithTimestampFragment
}
crash {
...CrashFragment
}
crashWithTimestamp {
...CrashWithTimestampFragment
}
}
lastData {
vehicleId
vehicle {
...VehicleFragment
}
timestamp
gps {
...GpsFragment
}
ignition {
...IgnitionFragment
}
driver {
...DriverFragment
}
canBus {
...CanBusFragment
}
driverBehaviour {
...DriverBehaviourFragment
}
temperatures {
...TemperaturesFragment
}
fleetMetaSensors {
...FleetMetaSensorsFragment
}
fuel {
...FuelFragment
}
misc {
...MiscFragment
}
locationTimestamp
locationTimeZone
}
assignedGroups {
id
version
createdAt
updatedAt
name
fleetId
parentId
externalId
description
isOwn
vehicleIds
assignedVehicles {
...VehicleFragment
}
}
assignedDevices {
id
serial
deviceTypeKey
enabled
phoneNumber
}
assignedLabels {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
}
lastOdometer
lastWorkingHours
deactivated
vehicleType {
id
name
}
customFields {
name
value
}
workSchedule {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
isDefault
beginGrace
endGrace
periods {
...WorkSchedulePeriodFragment
}
}
}
}
Variables
{"vin": "xyz789"}
Response
{
"data": {
"getVehiclesByVin": [
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": true,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"vin": "abc123",
"licensePlate": "abc123",
"make": "abc123",
"model": "abc123",
"year": 123,
"latestData": LatestData,
"lastData": CommonFormat,
"assignedGroups": [Group],
"assignedDevices": [Device],
"assignedLabels": [Label],
"lastOdometer": 987.65,
"lastWorkingHours": 987.65,
"deactivated": true,
"vehicleType": VehicleType,
"customFields": [CustomField],
"workSchedule": WorkSchedule
}
]
}
}
getWorkScheduleById
Description
Get single Device record by ID
Response
Returns a
WorkSchedule
Arguments
Name | Description |
---|---|
id -
UUID!
|
Example
Query
query GetWorkScheduleById($id: UUID!) {
getWorkScheduleById(id: $id) {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
isDefault
beginGrace
endGrace
periods {
weekday
begin
duration
}
}
}
Variables
{
"id": "daef229b-23db-4947-a472-3fbee2f43001"
}
Response
{
"data": {
"getWorkScheduleById": {
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": false,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"isDefault": false,
"beginGrace": 123,
"endGrace": 123,
"periods": [WorkSchedulePeriod]
}
}
}
getWorkSchedules
Description
Get all WorkSchedule records
Response
Returns
[WorkSchedule]
Example
Query
query GetWorkSchedules {
getWorkSchedules {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
isDefault
beginGrace
endGrace
periods {
weekday
begin
duration
}
}
}
Response
{
"data": {
"getWorkSchedules": [
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": true,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"isDefault": false,
"beginGrace": 987,
"endGrace": 123,
"periods": [WorkSchedulePeriod]
}
]
}
}
getWrappedReport
Description
Get reports
Response
Returns a
WrappedReport
Arguments
Name | Description |
---|---|
input -
WrappedReportInput!
|
Example
Query
query GetWrappedReport($input: WrappedReportInput!) {
getWrappedReport(input: $input) {
reportId
report
}
}
Variables
{"input": WrappedReportInput}
Response
{
"data": {
"getWrappedReport": {
"reportId": "xyz789",
"report": {}
}
}
}
getWrappedReportInputs
Description
Get available report parameters
Response
Returns
[WrappedReportInputs]
Arguments
Name | Description |
---|---|
id -
String
|
Example
Query
query GetWrappedReportInputs($id: String) {
getWrappedReportInputs(id: $id) {
id
title
description
onlyFleetTimezone
inputs
}
}
Variables
{"id": "xyz789"}
Response
{
"data": {
"getWrappedReportInputs": [
{
"id": "abc123",
"title": "abc123",
"description": "abc123",
"onlyFleetTimezone": true,
"inputs": {}
}
]
}
}
Mutations
changeVehiclesGroup
Description
Change vehicle to group relations
Response
Returns
[String]
Example
Query
mutation ChangeVehiclesGroup(
$vehicleIds: [UUID!]!,
$sourceGroupId: UUID!,
$destinationGroupId: UUID!
) {
changeVehiclesGroup(
vehicleIds: $vehicleIds,
sourceGroupId: $sourceGroupId,
destinationGroupId: $destinationGroupId
)
}
Variables
{
"vehicleIds": [
"daef229b-23db-4947-a472-3fbee2f43001"
],
"sourceGroupId": "daef229b-23db-4947-a472-3fbee2f43001",
"destinationGroupId": "daef229b-23db-4947-a472-3fbee2f43001"
}
Response
{
"data": {
"changeVehiclesGroup": ["xyz789"]
}
}
createGeofence
Description
Create Geofence entity
Response
Returns a
Geofence
Arguments
Name | Description |
---|---|
geofenceInput -
CreateGeofenceInput!
|
Example
Query
mutation CreateGeofence($geofenceInput: CreateGeofenceInput!) {
createGeofence(geofenceInput: $geofenceInput) {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
geojson
color
phone
email
address {
country
countryCode
region
city
postalCode
address
}
description
}
}
Variables
{"geofenceInput": CreateGeofenceInput}
Response
{
"data": {
"createGeofence": {
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": true,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"geojson": {},
"color": "abc123",
"phone": "abc123",
"email": "xyz789",
"address": Address,
"description": "xyz789"
}
}
}
createPerson
Description
Create new Person entity
Response
Returns a
Person
Arguments
Name | Description |
---|---|
personInput -
CreatePersonInput!
|
Example
Query
mutation CreatePerson($personInput: CreatePersonInput!) {
createPerson(personInput: $personInput) {
id
version
createdAt
updatedAt
isDeleted
isUser
isDriver
fleetId
email
firstName
lastName
globalUserId
licenseNumber
licenseIssuedIn
employeeId
customFields {
name
value
}
}
}
Variables
{"personInput": CreatePersonInput}
Response
{
"data": {
"createPerson": {
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": false,
"isUser": false,
"isDriver": false,
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"email": "xyz789",
"firstName": "abc123",
"lastName": "xyz789",
"globalUserId": "xyz789",
"licenseNumber": "xyz789",
"licenseIssuedIn": "xyz789",
"employeeId": "xyz789",
"customFields": [CustomField]
}
}
}
deleteGeofence
Description
Delete Geofence entity
updateGeofence
Description
Update Geofence entity fields, available in GeofenceInput
Response
Returns a
Geofence
Arguments
Name | Description |
---|---|
geofenceId -
UUID!
|
|
geofenceInput -
GeofenceInput!
|
Example
Query
mutation UpdateGeofence(
$geofenceId: UUID!,
$geofenceInput: GeofenceInput!
) {
updateGeofence(
geofenceId: $geofenceId,
geofenceInput: $geofenceInput
) {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
geojson
color
phone
email
address {
country
countryCode
region
city
postalCode
address
}
description
}
}
Variables
{
"geofenceId": "daef229b-23db-4947-a472-3fbee2f43001",
"geofenceInput": GeofenceInput
}
Response
{
"data": {
"updateGeofence": {
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": true,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"geojson": {},
"color": "abc123",
"phone": "xyz789",
"email": "xyz789",
"address": Address,
"description": "xyz789"
}
}
}
updatePerson
Description
Update Person entity fields, available in UpdatePersonInput
Response
Returns a
Person
Arguments
Name | Description |
---|---|
personId -
UUID!
|
|
personInput -
UpdatePersonInput!
|
Example
Query
mutation UpdatePerson(
$personId: UUID!,
$personInput: UpdatePersonInput!
) {
updatePerson(
personId: $personId,
personInput: $personInput
) {
id
version
createdAt
updatedAt
isDeleted
isUser
isDriver
fleetId
email
firstName
lastName
globalUserId
licenseNumber
licenseIssuedIn
employeeId
customFields {
name
value
}
}
}
Variables
{
"personId": "daef229b-23db-4947-a472-3fbee2f43001",
"personInput": UpdatePersonInput
}
Response
{
"data": {
"updatePerson": {
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": false,
"isUser": true,
"isDriver": true,
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"email": "xyz789",
"firstName": "abc123",
"lastName": "xyz789",
"globalUserId": "xyz789",
"licenseNumber": "abc123",
"licenseIssuedIn": "xyz789",
"employeeId": "abc123",
"customFields": [CustomField]
}
}
}
updatePersonCustomField
Description
Update CustomField entities, related to user
Response
Returns a
CustomField
Arguments
Name | Description |
---|---|
personId -
UUID!
|
|
field -
CustomFieldInput!
|
Example
Query
mutation UpdatePersonCustomField(
$personId: UUID!,
$field: CustomFieldInput!
) {
updatePersonCustomField(
personId: $personId,
field: $field
) {
name
value
}
}
Variables
{
"personId": "daef229b-23db-4947-a472-3fbee2f43001",
"field": CustomFieldInput
}
Response
{
"data": {
"updatePersonCustomField": {
"name": "abc123",
"value": "abc123"
}
}
}
updateVehicle
Description
Update Vehicle entity fields, available in VehicleInput
Response
Returns a
Vehicle
Arguments
Name | Description |
---|---|
vehicleId -
UUID!
|
|
vehicleInput -
VehicleInput!
|
Example
Query
mutation UpdateVehicle(
$vehicleId: UUID!,
$vehicleInput: VehicleInput!
) {
updateVehicle(
vehicleId: $vehicleId,
vehicleInput: $vehicleInput
) {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
vin
licensePlate
make
model
year
latestData {
timestamp
gps {
...GpsFragment
}
gpsWithTimestamp {
...GpsWithTimestampFragment
}
odometer {
...FloatWithTimestampFragment
}
workingHours {
...FloatWithTimestampFragment
}
address {
...AddressFragment
}
speedLimit {
...SpeedLimitFragment
}
geofenceData {
...GeofenceDataFragment
}
metaSensorData {
...SensorDataFragment
}
ptoHoursData {
...LongWithTimestampFragment
}
driverData {
...DriverDataFragment
}
canBus {
...CanBusFragment
}
canBusWithTimestamp {
...CanBusWithTimestampFragment
}
ignition {
...IgnitionFragment
}
ignitionWithTimestamp {
...IgnitionWithTimestampFragment
}
driverBehaviour {
...DriverBehaviourFragment
}
driverBehaviourWithTimestamp {
...DriverBehaviourWithTimestampFragment
}
temperatures {
...TemperaturesFragment
}
temperaturesWithTimestamp {
...TemperaturesWithTimestampFragment
}
fuel {
...FuelFragment
}
fuelWithTimestamp {
...FuelWithTimestampFragment
}
misc {
...MiscFragment
}
miscWithTimestamp {
...MiscWithTimestampFragment
}
crash {
...CrashFragment
}
crashWithTimestamp {
...CrashWithTimestampFragment
}
}
lastData {
vehicleId
vehicle {
...VehicleFragment
}
timestamp
gps {
...GpsFragment
}
ignition {
...IgnitionFragment
}
driver {
...DriverFragment
}
canBus {
...CanBusFragment
}
driverBehaviour {
...DriverBehaviourFragment
}
temperatures {
...TemperaturesFragment
}
fleetMetaSensors {
...FleetMetaSensorsFragment
}
fuel {
...FuelFragment
}
misc {
...MiscFragment
}
locationTimestamp
locationTimeZone
}
assignedGroups {
id
version
createdAt
updatedAt
name
fleetId
parentId
externalId
description
isOwn
vehicleIds
assignedVehicles {
...VehicleFragment
}
}
assignedDevices {
id
serial
deviceTypeKey
enabled
phoneNumber
}
assignedLabels {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
}
lastOdometer
lastWorkingHours
deactivated
vehicleType {
id
name
}
customFields {
name
value
}
workSchedule {
id
version
createdAt
updatedAt
isDeleted
name
fleetId
isDefault
beginGrace
endGrace
periods {
...WorkSchedulePeriodFragment
}
}
}
}
Variables
{
"vehicleId": "daef229b-23db-4947-a472-3fbee2f43001",
"vehicleInput": VehicleInput
}
Response
{
"data": {
"updateVehicle": {
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": false,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"vin": "abc123",
"licensePlate": "abc123",
"make": "abc123",
"model": "abc123",
"year": 987,
"latestData": LatestData,
"lastData": CommonFormat,
"assignedGroups": [Group],
"assignedDevices": [Device],
"assignedLabels": [Label],
"lastOdometer": 123.45,
"lastWorkingHours": 987.65,
"deactivated": false,
"vehicleType": VehicleType,
"customFields": [CustomField],
"workSchedule": WorkSchedule
}
}
}
updateVehicleCustomField
Description
Update CustomField entities, related to vehicle
Response
Returns a
CustomField
Arguments
Name | Description |
---|---|
vehicleId -
UUID!
|
|
field -
CustomFieldInput!
|
Example
Query
mutation UpdateVehicleCustomField(
$vehicleId: UUID!,
$field: CustomFieldInput!
) {
updateVehicleCustomField(
vehicleId: $vehicleId,
field: $field
) {
name
value
}
}
Variables
{
"vehicleId": "daef229b-23db-4947-a472-3fbee2f43001",
"field": CustomFieldInput
}
Response
{
"data": {
"updateVehicleCustomField": {
"name": "xyz789",
"value": "abc123"
}
}
}
Types
Address
AddressInput
Example
{
"address": "abc123",
"city": "xyz789",
"region": "xyz789",
"countryCode": "xyz789",
"postalCode": "abc123",
"fieldMask": ["address"]
}
AddressInputFields
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
Example
"address"
Boolean
Description
The Boolean
scalar type represents true
or false
.
BooleanWithTimestamp
CanAxleWeightsMap
CanAxleWeightsMapWithTimestamp
CanBus
Description
Data items read from vehicle CAN bus
Fields
Field Name | Description |
---|---|
absStatus -
Boolean
|
Indicates whether ABS is on or off |
acceleratorPedalPosition -
Float
|
Actual position of the accelerator pedal (not to be confused with engine_throttle_position)(%) |
accelerationX -
Float
|
x-axis acceleration component (m/s2) |
accelerationY -
Float
|
y-axis acceleration component (m/s2) |
ambientAirTemperature -
Float
|
(degrees C) |
barometricPressure -
Float
|
(kPa) |
brakeApplicationPressure -
Float
|
(kPa) |
brakePedalPosition -
Float
|
(%) |
brakePedalState -
Boolean
|
|
brakeTorque -
Float
|
(Nm) |
canCombinationWeight -
Float
|
Tractor and trailer combination gross weight (kg) |
combinationWeight -
Float
|
Calculated from axle weights + trailer weight. Only output when the CANCombinationWeight parameter not present. (kg) |
canrpm -
Float
|
CANRPM |
canDistance -
Float
|
Odometer (km) |
canDeltaDistance -
Float
|
Delta distance from previous (record or measurement?) (km) |
canTripDistance -
Float
|
Trip distance (km) |
canFuelUsed -
Float
|
Total fuel used by vehicle |
canTripFuelUsed -
Float
|
Fuel used during trip (l) |
canTripFuelUsedPercent -
Float
|
Fuel used during trip, in percentage of tank (%) |
canServiceDistance -
Float
|
(km) |
canFuelRate -
Float
|
(l/h) |
canhrFuelUsed -
Float
|
Total fuel used by vehicle, high resolution. If present, should be mapped to CANFuelUsed, which is the canonical name. |
canSpeed -
Float
|
(km/h) |
canFuel -
Float
|
Calibrated fuel value read from CAN bus. Should be remapped to 'Fuel' which is the canonical name. |
canRawFuel -
Float
|
Uncalibrated fuel value read from CAN bus. Can be either deciliters or percent of tank volume. |
canAxleNumber -
Float
|
The axle number referenced by CANAxleWeight. PGN 0x00FEEA in the FMS standard. |
canAxleWeight -
Float
|
The load of the axle referenced in CANAxleNumber in kg |
canAxleWeights -
[CanAxleWeightsMap]
|
Contains a JSON object of all known axle load values |
canEngineCoolantTemperature -
Float
|
The same as CANTemperature |
canEngineHours -
Float
|
|
canFuelEconomy -
Float
|
Instantaneous fuel economy of PGN 0x00FEF2 in the FMS standard. Unit is km/l. Probably not actually used |
canWheelSpeed -
Float
|
The same as CANSpeed |
cargoWeight -
Float
|
(kg) |
checkEngineWarning -
Boolean
|
MIL state |
clutchPedalState -
Boolean
|
|
cruiseControlState -
Long
|
Probably raw enum from J1939, in decimal (number) |
deltaFuelUsed -
Float
|
|
engineCoolantLevel -
Float
|
(%) |
engineCoolantPressure -
Float
|
(kPa) |
engineFuelType -
Long
|
Enum of bus values (same for OBD and 1939?) (number) |
engineOilLevel -
Float
|
(%) |
engineOilPressure -
Float
|
(kPa) |
engineOilTemperature -
Float
|
(degrees C) |
enginePercentLoad -
Float
|
(%) |
engineRunTime -
Float
|
(s) |
engineThrottlePosition -
Float
|
The position of the throttle valve (can be controlled by the accelerator pedal (accelerator_pedal_position) or by another ECU i.e. while driving on cruise control) (%) |
engineIdleTime -
Float
|
Total engine idle time over the life of the vehicle (hours) |
engineWorkTime -
Float
|
Total engine time over the life of the vehicle (hours) |
fuelDeliveryPressure -
Float
|
(kPa) |
gear -
String
|
Selected gear lever position (Park, Reverse, Neutral, Drive, Sport, Low, Gear_1, etc) (string) |
intakeAirTemperature -
Float
|
(degrees C) |
massAirFlow -
Float
|
|
oilLifeRemaining -
Float
|
Remaining oil life (%) |
overweight -
Boolean
|
|
parkingBrakeSwitch -
Boolean
|
|
seatBeltDriver -
Boolean
|
|
seatBeltPassenger -
Boolean
|
|
seatOccupiedDriver -
Boolean
|
|
seatOccupiedPassenger -
Boolean
|
|
serviceNowWarning -
Boolean
|
|
tirePressureWarning -
Boolean
|
|
tirePressure -
[TirePressureMap]
|
Key-value pairs. The key is a pair of numbers where the first number counts the axle of the tire from front to rear and the second number counts the position of the tire from left to right. The value is tire pressure in kPa. (kPa) |
tirePressureStatus -
[TirePressureStatusMap]
|
Key-value pairs. The key is a pair of numbers where the first number counts the axle of the tire from front to rear and the second number counts the position of the tire from left to right. The value is tire pressure status: Normal, Low, Alert. (string) |
tirePressurePlacardFront -
Float
|
Recommended front tire pressure (kPa) |
tirePressurePlacardRear -
Float
|
Recommended rear tire pressure (kPa) |
tireLocation -
String
|
|
tractionControl -
Boolean
|
Indicates whether the traction control is on or off. |
tractionControlBrake -
Boolean
|
Indicates whether the traction control brake is on or off |
tractionControlPowerTrain -
Boolean
|
Indicates whether the traction control powertrain is on or off |
transmissionOilTemperature -
Float
|
(degrees C) |
washerFluidLevel -
Float
|
(%) |
waterInFuel -
Boolean
|
|
canFuelConsumption -
Float
|
(l/100km) |
frontLeftDoorOpen -
Boolean
|
|
frontRightDoorStatus -
Boolean
|
|
hoodOpen -
Boolean
|
|
rearLeftDoorOpen -
Boolean
|
|
rearRightDoorOpen -
Boolean
|
|
trunkOpen -
Boolean
|
|
canProgramNumber -
Long
|
|
cruiseControlActive -
Boolean
|
1 - active; 0 - inactive |
retarderTorqueMode -
Int
|
Enum value |
actualRetarderLevel -
Float
|
(%) |
nonEngineRetarderSelectionLevel -
Float
|
(%) |
Example
{
"absStatus": true,
"acceleratorPedalPosition": 987.65,
"accelerationX": 987.65,
"accelerationY": 123.45,
"ambientAirTemperature": 123.45,
"barometricPressure": 987.65,
"brakeApplicationPressure": 123.45,
"brakePedalPosition": 123.45,
"brakePedalState": true,
"brakeTorque": 987.65,
"canCombinationWeight": 123.45,
"combinationWeight": 987.65,
"canrpm": 123.45,
"canDistance": 123.45,
"canDeltaDistance": 123.45,
"canTripDistance": 987.65,
"canFuelUsed": 987.65,
"canTripFuelUsed": 987.65,
"canTripFuelUsedPercent": 123.45,
"canServiceDistance": 987.65,
"canFuelRate": 987.65,
"canhrFuelUsed": 123.45,
"canSpeed": 123.45,
"canFuel": 987.65,
"canRawFuel": 123.45,
"canAxleNumber": 123.45,
"canAxleWeight": 987.65,
"canAxleWeights": [CanAxleWeightsMap],
"canEngineCoolantTemperature": 987.65,
"canEngineHours": 123.45,
"canFuelEconomy": 987.65,
"canWheelSpeed": 123.45,
"cargoWeight": 123.45,
"checkEngineWarning": false,
"clutchPedalState": false,
"cruiseControlState": {},
"deltaFuelUsed": 987.65,
"engineCoolantLevel": 123.45,
"engineCoolantPressure": 123.45,
"engineFuelType": {},
"engineOilLevel": 987.65,
"engineOilPressure": 123.45,
"engineOilTemperature": 123.45,
"enginePercentLoad": 123.45,
"engineRunTime": 987.65,
"engineThrottlePosition": 123.45,
"engineIdleTime": 987.65,
"engineWorkTime": 987.65,
"fuelDeliveryPressure": 987.65,
"gear": "abc123",
"intakeAirTemperature": 123.45,
"massAirFlow": 123.45,
"oilLifeRemaining": 123.45,
"overweight": false,
"parkingBrakeSwitch": true,
"seatBeltDriver": true,
"seatBeltPassenger": true,
"seatOccupiedDriver": false,
"seatOccupiedPassenger": false,
"serviceNowWarning": false,
"tirePressureWarning": false,
"tirePressure": [TirePressureMap],
"tirePressureStatus": [TirePressureStatusMap],
"tirePressurePlacardFront": 123.45,
"tirePressurePlacardRear": 123.45,
"tireLocation": "abc123",
"tractionControl": false,
"tractionControlBrake": false,
"tractionControlPowerTrain": true,
"transmissionOilTemperature": 123.45,
"washerFluidLevel": 987.65,
"waterInFuel": true,
"canFuelConsumption": 123.45,
"frontLeftDoorOpen": false,
"frontRightDoorStatus": true,
"hoodOpen": false,
"rearLeftDoorOpen": false,
"rearRightDoorOpen": true,
"trunkOpen": false,
"canProgramNumber": {},
"cruiseControlActive": false,
"retarderTorqueMode": 987,
"actualRetarderLevel": 123.45,
"nonEngineRetarderSelectionLevel": 987.65
}
CanBusWithTimestamp
Description
Data items read from vehicle CAN bus
Fields
Field Name | Description |
---|---|
absStatus -
BooleanWithTimestamp
|
Indicates whether ABS is on or off |
acceleratorPedalPosition -
FloatWithTimestamp
|
Actual position of the accelerator pedal (not to be confused with engine_throttle_position)(%) |
accelerationX -
FloatWithTimestamp
|
x-axis acceleration component (m/s2) |
accelerationY -
FloatWithTimestamp
|
y-axis acceleration component (m/s2) |
ambientAirTemperature -
FloatWithTimestamp
|
(degrees C) |
barometricPressure -
FloatWithTimestamp
|
(kPa) |
brakeApplicationPressure -
FloatWithTimestamp
|
(kPa) |
brakePedalPosition -
FloatWithTimestamp
|
(%) |
brakePedalState -
BooleanWithTimestamp
|
|
brakeTorque -
FloatWithTimestamp
|
(Nm) |
canCombinationWeight -
FloatWithTimestamp
|
Tractor and trailer combination gross weight (kg) |
combinationWeight -
FloatWithTimestamp
|
Calculated from axle weights + trailer weight. Only output when the CANCombinationWeight parameter not present. (kg) |
canrpm -
FloatWithTimestamp
|
CANRPM |
canDistance -
FloatWithTimestamp
|
Odometer (km) |
canDeltaDistance -
FloatWithTimestamp
|
Delta distance from previous (record or measurement?) (km) |
canTripDistance -
FloatWithTimestamp
|
Trip distance (km) |
canFuelUsed -
FloatWithTimestamp
|
Total fuel used by vehicle |
canTripFuelUsed -
FloatWithTimestamp
|
Fuel used during trip (l) |
canTripFuelUsedPercent -
FloatWithTimestamp
|
Fuel used during trip, in percentage of tank (%) |
canServiceDistance -
FloatWithTimestamp
|
(km) |
canFuelRate -
FloatWithTimestamp
|
(l/h) |
canhrFuelUsed -
FloatWithTimestamp
|
Total fuel used by vehicle, high resolution. If present, should be mapped to CANFuelUsed, which is the canonical name. |
canSpeed -
FloatWithTimestamp
|
(km/h) |
canFuel -
FloatWithTimestamp
|
Calibrated fuel value read from CAN bus. Should be remapped to 'Fuel' which is the canonical name. |
canRawFuel -
FloatWithTimestamp
|
Uncalibrated fuel value read from CAN bus. Can be either deciliters or percent of tank volume. |
canAxleNumber -
FloatWithTimestamp
|
The axle number referenced by CANAxleWeight. PGN 0x00FEEA in the FMS standard. |
canAxleWeight -
FloatWithTimestamp
|
The load of the axle referenced in CANAxleNumber in kg |
canEngineCoolantTemperature -
FloatWithTimestamp
|
The same as CANTemperature |
canEngineHours -
FloatWithTimestamp
|
|
canFuelEconomy -
FloatWithTimestamp
|
Instantaneous fuel economy of PGN 0x00FEF2 in the FMS standard. Unit is km/l. Probably not actually used |
canWheelSpeed -
FloatWithTimestamp
|
The same as CANSpeed |
cargoWeight -
FloatWithTimestamp
|
(kg) |
checkEngineWarning -
BooleanWithTimestamp
|
MIL state |
clutchPedalState -
BooleanWithTimestamp
|
|
cruiseControlState -
LongWithTimestamp
|
Probably raw enum from J1939, in decimal (number) |
deltaFuelUsed -
FloatWithTimestamp
|
|
engineCoolantLevel -
FloatWithTimestamp
|
(%) |
engineCoolantPressure -
FloatWithTimestamp
|
(kPa) |
engineFuelType -
LongWithTimestamp
|
Enum of bus values (same for OBD and 1939?) (number) |
engineOilLevel -
FloatWithTimestamp
|
(%) |
engineOilPressure -
FloatWithTimestamp
|
(kPa) |
engineOilTemperature -
FloatWithTimestamp
|
(degrees C) |
enginePercentLoad -
FloatWithTimestamp
|
(%) |
engineRunTime -
FloatWithTimestamp
|
(s) |
engineThrottlePosition -
FloatWithTimestamp
|
The position of the throttle valve (can be controlled by the accelerator pedal (accelerator_pedal_position) or by another ECU i.e. while driving on cruise control) (%) |
engineIdleTime -
FloatWithTimestamp
|
Total engine idle time over the life of the vehicle (hours) |
engineWorkTime -
FloatWithTimestamp
|
Total engine time over the life of the vehicle (hours) |
fuelDeliveryPressure -
FloatWithTimestamp
|
(kPa) |
gear -
StringWithTimestamp
|
Selected gear lever position (Park, Reverse, Neutral, Drive, Sport, Low, Gear_1, etc) (string) |
intakeAirTemperature -
FloatWithTimestamp
|
(degrees C) |
massAirFlow -
FloatWithTimestamp
|
|
oilLifeRemaining -
FloatWithTimestamp
|
Remaining oil life (%) |
overweight -
BooleanWithTimestamp
|
|
parkingBrakeSwitch -
BooleanWithTimestamp
|
|
seatBeltDriver -
BooleanWithTimestamp
|
|
seatBeltPassenger -
BooleanWithTimestamp
|
|
seatOccupiedDriver -
BooleanWithTimestamp
|
|
seatOccupiedPassenger -
BooleanWithTimestamp
|
|
serviceNowWarning -
BooleanWithTimestamp
|
|
tirePressureWarning -
BooleanWithTimestamp
|
|
tirePressurePlacardFront -
FloatWithTimestamp
|
Recommended front tire pressure (kPa) |
tirePressurePlacardRear -
FloatWithTimestamp
|
Recommended rear tire pressure (kPa) |
tireLocation -
StringWithTimestamp
|
|
tractionControl -
BooleanWithTimestamp
|
Indicates whether the traction control is on or off. |
tractionControlBrake -
BooleanWithTimestamp
|
Indicates whether the traction control brake is on or off |
tractionControlPowerTrain -
BooleanWithTimestamp
|
Indicates whether the traction control powertrain is on or off |
transmissionOilTemperature -
FloatWithTimestamp
|
(degrees C) |
washerFluidLevel -
FloatWithTimestamp
|
(%) |
waterInFuel -
BooleanWithTimestamp
|
|
canFuelConsumption -
FloatWithTimestamp
|
(l/100km) |
frontLeftDoorOpen -
BooleanWithTimestamp
|
|
frontRightDoorStatus -
BooleanWithTimestamp
|
|
hoodOpen -
BooleanWithTimestamp
|
|
rearLeftDoorOpen -
BooleanWithTimestamp
|
|
rearRightDoorOpen -
BooleanWithTimestamp
|
|
trunkOpen -
BooleanWithTimestamp
|
|
canProgramNumber -
LongWithTimestamp
|
|
cruiseControlActive -
BooleanWithTimestamp
|
1 - active; 0 - inactive |
retarderTorqueMode -
IntWithTimestamp
|
Enum value |
actualRetarderLevel -
FloatWithTimestamp
|
(%) |
nonEngineRetarderSelectionLevel -
FloatWithTimestamp
|
(%) |
canAxleWeights -
[CanAxleWeightsMapWithTimestamp]
|
Contains a JSON object of all known axle load values |
tirePressure -
[TirePressureMapWithTimestamp]
|
Key-value pairs. The key is a pair of numbers where the first number counts the axle of the tire from front to rear and the second number counts the position of the tire from left to right. The value is tire pressure in kPa. (kPa) |
tirePressureStatus -
[TirePressureStatusMapWithTimestamp]
|
Key-value pairs. The key is a pair of numbers where the first number counts the axle of the tire from front to rear and the second number counts the position of the tire from left to right. The value is tire pressure status: Normal, Low, Alert. (string) |
Example
{
"absStatus": BooleanWithTimestamp,
"acceleratorPedalPosition": FloatWithTimestamp,
"accelerationX": FloatWithTimestamp,
"accelerationY": FloatWithTimestamp,
"ambientAirTemperature": FloatWithTimestamp,
"barometricPressure": FloatWithTimestamp,
"brakeApplicationPressure": FloatWithTimestamp,
"brakePedalPosition": FloatWithTimestamp,
"brakePedalState": BooleanWithTimestamp,
"brakeTorque": FloatWithTimestamp,
"canCombinationWeight": FloatWithTimestamp,
"combinationWeight": FloatWithTimestamp,
"canrpm": FloatWithTimestamp,
"canDistance": FloatWithTimestamp,
"canDeltaDistance": FloatWithTimestamp,
"canTripDistance": FloatWithTimestamp,
"canFuelUsed": FloatWithTimestamp,
"canTripFuelUsed": FloatWithTimestamp,
"canTripFuelUsedPercent": FloatWithTimestamp,
"canServiceDistance": FloatWithTimestamp,
"canFuelRate": FloatWithTimestamp,
"canhrFuelUsed": FloatWithTimestamp,
"canSpeed": FloatWithTimestamp,
"canFuel": FloatWithTimestamp,
"canRawFuel": FloatWithTimestamp,
"canAxleNumber": FloatWithTimestamp,
"canAxleWeight": FloatWithTimestamp,
"canEngineCoolantTemperature": FloatWithTimestamp,
"canEngineHours": FloatWithTimestamp,
"canFuelEconomy": FloatWithTimestamp,
"canWheelSpeed": FloatWithTimestamp,
"cargoWeight": FloatWithTimestamp,
"checkEngineWarning": BooleanWithTimestamp,
"clutchPedalState": BooleanWithTimestamp,
"cruiseControlState": LongWithTimestamp,
"deltaFuelUsed": FloatWithTimestamp,
"engineCoolantLevel": FloatWithTimestamp,
"engineCoolantPressure": FloatWithTimestamp,
"engineFuelType": LongWithTimestamp,
"engineOilLevel": FloatWithTimestamp,
"engineOilPressure": FloatWithTimestamp,
"engineOilTemperature": FloatWithTimestamp,
"enginePercentLoad": FloatWithTimestamp,
"engineRunTime": FloatWithTimestamp,
"engineThrottlePosition": FloatWithTimestamp,
"engineIdleTime": FloatWithTimestamp,
"engineWorkTime": FloatWithTimestamp,
"fuelDeliveryPressure": FloatWithTimestamp,
"gear": StringWithTimestamp,
"intakeAirTemperature": FloatWithTimestamp,
"massAirFlow": FloatWithTimestamp,
"oilLifeRemaining": FloatWithTimestamp,
"overweight": BooleanWithTimestamp,
"parkingBrakeSwitch": BooleanWithTimestamp,
"seatBeltDriver": BooleanWithTimestamp,
"seatBeltPassenger": BooleanWithTimestamp,
"seatOccupiedDriver": BooleanWithTimestamp,
"seatOccupiedPassenger": BooleanWithTimestamp,
"serviceNowWarning": BooleanWithTimestamp,
"tirePressureWarning": BooleanWithTimestamp,
"tirePressurePlacardFront": FloatWithTimestamp,
"tirePressurePlacardRear": FloatWithTimestamp,
"tireLocation": StringWithTimestamp,
"tractionControl": BooleanWithTimestamp,
"tractionControlBrake": BooleanWithTimestamp,
"tractionControlPowerTrain": BooleanWithTimestamp,
"transmissionOilTemperature": FloatWithTimestamp,
"washerFluidLevel": FloatWithTimestamp,
"waterInFuel": BooleanWithTimestamp,
"canFuelConsumption": FloatWithTimestamp,
"frontLeftDoorOpen": BooleanWithTimestamp,
"frontRightDoorStatus": BooleanWithTimestamp,
"hoodOpen": BooleanWithTimestamp,
"rearLeftDoorOpen": BooleanWithTimestamp,
"rearRightDoorOpen": BooleanWithTimestamp,
"trunkOpen": BooleanWithTimestamp,
"canProgramNumber": LongWithTimestamp,
"cruiseControlActive": BooleanWithTimestamp,
"retarderTorqueMode": IntWithTimestamp,
"actualRetarderLevel": FloatWithTimestamp,
"nonEngineRetarderSelectionLevel": FloatWithTimestamp,
"canAxleWeights": [CanAxleWeightsMapWithTimestamp],
"tirePressure": [TirePressureMapWithTimestamp],
"tirePressureStatus": [
TirePressureStatusMapWithTimestamp
]
}
CommonFormat
Fields
Field Name | Description |
---|---|
vehicleId -
UUID
|
|
vehicle -
Vehicle
|
|
timestamp -
DateTime
|
Snapshot date and time in UTC |
gps -
Gps
|
GPS-originated data |
ignition -
Ignition
|
Ignition-related |
driver -
Driver
|
DriverId and related |
canBus -
CanBus
|
Data items read from vehicle CAN bus |
driverBehaviour -
DriverBehaviour
|
Data items related to driver behaviour |
temperatures -
Temperatures
|
Temperatures measured by sensor (degrees C) |
fleetMetaSensors -
FleetMetaSensors
|
|
fuel -
Fuel
|
Fuel (probe-originated) and related fields |
misc -
Misc
|
Various data items |
locationTimestamp -
DateTime
|
Local timestamp, based on current GPS coordinates |
locationTimeZone -
String
|
Local timezone, based on current GPS coordinates |
Example
{
"vehicleId": "daef229b-23db-4947-a472-3fbee2f43001",
"vehicle": Vehicle,
"timestamp": "2007-12-03T10:15:30Z",
"gps": Gps,
"ignition": Ignition,
"driver": Driver,
"canBus": CanBus,
"driverBehaviour": DriverBehaviour,
"temperatures": Temperatures,
"fleetMetaSensors": FleetMetaSensors,
"fuel": Fuel,
"misc": Misc,
"locationTimestamp": "2007-12-03T10:15:30Z",
"locationTimeZone": "xyz789"
}
Crash
Description
Crash data. This is caused by a 'high G event'. These values are normally '1'. It may be worth considering have a generic events flag base enum that would contain CRASH in this event.
Example
{"crashId": {}, "severity": {}}
CrashWithTimestamp
Description
Crash data. This is caused by a 'high G event'. These values are normally '1'. It may be worth considering have a generic events flag base enum that would contain CRASH in this event.
Fields
Field Name | Description |
---|---|
crashId -
LongWithTimestamp
|
The crash id. |
severity -
LongWithTimestamp
|
The crash severity. |
Example
{
"crashId": LongWithTimestamp,
"severity": LongWithTimestamp
}
CreateGeofenceInput
Fields
Input Field | Description |
---|---|
name -
String
|
|
address -
AddressInput
|
|
color -
String
|
HEX code, example: 003366 (^([a-fA-F0-9]{6})$) |
description -
String
|
|
email -
String
|
|
geojson -
JSON
|
geojson Feature format ( https://datatracker.ietf.org/doc/html/rfc7946#section-3.2). Collections not supported. |
phone -
String
|
Example
{
"name": "xyz789",
"address": AddressInput,
"color": "abc123",
"description": "xyz789",
"email": "xyz789",
"geojson": {},
"phone": "xyz789"
}
CreatePersonInput
Description
Person mutation parameter, containing values to be changed and field mask to enforce the changes
Example
{
"email": "abc123",
"firstName": "xyz789",
"lastName": "abc123",
"licenseNumber": "abc123",
"licenseIssuedIn": "abc123",
"employeeId": "xyz789",
"isDriver": false
}
CustomField
CustomFieldInput
DateTime
Example
"2007-12-03T10:15:30Z"
DayOfWeek
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"MONDAY"
Device
Driver
Description
DriverId and related
Fields
Field Name | Description |
---|---|
driverId -
String
|
Canonical driver ID (required by app backend to be present for all HW types) |
iButton -
String
|
Serial number of IButton (bytes reordered to match the actual value printed on some keys), without Dallas family code and checksum |
oneWire -
String
|
Unaltered 1wire sentence containing IButton serial number (without reordered bytes), Dallas family code and checksum |
rfidIButton -
Long
|
Decimal form of RFID card serial number (4 highest bytes) read with card reader that pretends to be an IButton. |
rfidIButtonHex -
String
|
Hexadecimal form of the previous. |
rfidIButtonReversed -
Long
|
Decimal form of RFID card serial number (4 lowest bytes), with bytes reordered (similarly to IButton), read with card reader that pretends to be an IButton. |
rfidIButtonReversedHex -
String
|
Hexadecimal form of the previous |
rfid -
Long
|
Serial number of RFID card (read with RS232 reader), also supports 7byte serial numbers. Decimal form |
rfidHex -
String
|
Hexadecimal form of the previous |
Example
{
"driverId": "xyz789",
"iButton": "abc123",
"oneWire": "abc123",
"rfidIButton": {},
"rfidIButtonHex": "abc123",
"rfidIButtonReversed": {},
"rfidIButtonReversedHex": "xyz789",
"rfid": {},
"rfidHex": "xyz789"
}
DriverBehaviour
Description
Data items related to driver behaviour
Fields
Field Name | Description |
---|---|
driverBehaviourType -
DriverBehaviourType
|
Enum with different behaviour types |
driverBehaviourValue -
Float
|
Example
{
"driverBehaviourType": "DRIVER_BEHAVIOUR_TYPE_UNKNOWN",
"driverBehaviourValue": 123.45
}
DriverBehaviourType
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"DRIVER_BEHAVIOUR_TYPE_UNKNOWN"
DriverBehaviourTypeWithTimestamp
Fields
Field Name | Description |
---|---|
timestamp -
Long
|
Timestamp indicating last appearance of value in record |
changeTimestamp -
Long
|
Timestamp indicating last change time |
value -
DriverBehaviourType
|
DriverBehaviourType value |
Example
{
"timestamp": {},
"changeTimestamp": {},
"value": "DRIVER_BEHAVIOUR_TYPE_UNKNOWN"
}
DriverBehaviourWithTimestamp
Fields
Field Name | Description |
---|---|
driverBehaviourType -
DriverBehaviourTypeWithTimestamp
|
|
driverBehaviourValue -
FloatWithTimestamp
|
Example
{
"driverBehaviourType": DriverBehaviourTypeWithTimestamp,
"driverBehaviourValue": FloatWithTimestamp
}
DriverData
Fields
Field Name | Description |
---|---|
driverId -
UUID
|
Example
{
"driverId": "daef229b-23db-4947-a472-3fbee2f43001"
}
FleetMetaSensors
Fields
Field Name | Description |
---|---|
sensors -
[SensorMap]
|
Example
{"sensors": [SensorMap]}
FleetUserInfo
Float
Description
The Float
scalar type represents signed double-precision fractional values as specified by
IEEE 754.
Example
123.45
FloatWithTimestamp
Fuel
Fields
Field Name | Description |
---|---|
fuel -
Float
|
The canonical Fuel field, contains the amount of fuel in the fuel tank (sum of two tanks, in case of vehicles with two fuel tanks) in liters |
rawFuel -
[RawFuelMap]
|
The raw (uncalibrated) value of the fuel probe in the fuel tanks, for certain device types |
pulseCount -
Long
|
The impulse count of fuel flow meter |
fuelLevel -
[FuelLevelMap]
|
Fuel level in percent |
totalFuelEconomy -
Float
|
|
fuelTankSize -
Float
|
Example
{
"fuel": 987.65,
"rawFuel": [RawFuelMap],
"pulseCount": {},
"fuelLevel": [FuelLevelMap],
"totalFuelEconomy": 123.45,
"fuelTankSize": 123.45
}
FuelLevelMap
FuelLevelMapWithTimestamp
FuelWithTimestamp
Description
Fuel (probe-originated) and related fields
Fields
Field Name | Description |
---|---|
fuel -
FloatWithTimestamp
|
The canonical Fuel field, contains the amount of fuel in the fuel tank (sum of two tanks, in case of vehicles with two fuel tanks) in liters |
pulseCount -
LongWithTimestamp
|
The impulse count of fuel flow meter |
totalFuelEconomy -
FloatWithTimestamp
|
|
fuelTankSize -
FloatWithTimestamp
|
|
rawFuel -
[RawFuelMapWithTimestamp]
|
The raw (uncalibrated) value of the fuel probe in the fuel tanks, for certain device types |
fuelLevel -
[FuelLevelMapWithTimestamp]
|
Fuel level in percent |
Example
{
"fuel": FloatWithTimestamp,
"pulseCount": LongWithTimestamp,
"totalFuelEconomy": FloatWithTimestamp,
"fuelTankSize": FloatWithTimestamp,
"rawFuel": [RawFuelMapWithTimestamp],
"fuelLevel": [FuelLevelMapWithTimestamp]
}
Geofence
Fields
Field Name | Description |
---|---|
id -
UUID!
|
|
version -
Long!
|
|
createdAt -
Long!
|
UTC, unix epoch milliseconds |
updatedAt -
Long!
|
UTC, unix epoch milliseconds |
isDeleted -
Boolean!
|
|
name -
String
|
|
fleetId -
UUID!
|
|
geojson -
JSON
|
geojson Feature format ( https://datatracker.ietf.org/doc/html/rfc7946#section-3.2). Collections not supported. |
color -
String
|
HEX code, example: 003366 (^([a-fA-F0-9]{6})$) |
phone -
String
|
|
email -
String
|
|
address -
Address
|
|
description -
String
|
Example
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": true,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"geojson": {},
"color": "xyz789",
"phone": "abc123",
"email": "abc123",
"address": Address,
"description": "xyz789"
}
GeofenceData
Fields
Field Name | Description |
---|---|
geofenceIds -
[UUID]
|
|
geofences -
[Geofence]
|
Use getGeofences query for geofences details |
Example
{
"geofenceIds": [
"daef229b-23db-4947-a472-3fbee2f43001"
],
"geofences": [Geofence]
}
GeofenceInput
Fields
Input Field | Description |
---|---|
name -
String
|
|
address -
AddressInput
|
|
color -
String
|
HEX code, example: 003366 (^([a-fA-F0-9]{6})$) |
description -
String
|
|
email -
String
|
|
geojson -
JSON
|
geojson Feature format ( https://datatracker.ietf.org/doc/html/rfc7946#section-3.2). Collections not supported. |
phone -
String
|
|
fieldMask -
[GeofenceInputFields!]!
|
Example
{
"name": "xyz789",
"address": AddressInput,
"color": "xyz789",
"description": "abc123",
"email": "abc123",
"geojson": {},
"phone": "abc123",
"fieldMask": ["name"]
}
GeofenceInputFields
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"name"
Gps
Description
GPS-originated data
Fields
Field Name | Description |
---|---|
state -
Boolean
|
Sourced from A/V evaluation of GPRMC sentence, where available |
latitude -
Float
|
The value here is arc minutes (degree * 60) (minutes) |
longitude -
Float
|
The value here is arc minutes (degree * 60) (minutes) |
direction -
Float
|
The direction the vehicle is heading in degrees |
altitude -
Float
|
(meters) |
speed -
Float
|
(km/h) |
satellites -
Long
|
Number of satellites used |
hdop -
Float
|
horizontal dilution of precision |
Example
{
"state": false,
"latitude": 123.45,
"longitude": 987.65,
"direction": 123.45,
"altitude": 123.45,
"speed": 987.65,
"satellites": {},
"hdop": 987.65
}
GpsWithTimestamp
Fields
Field Name | Description |
---|---|
state -
BooleanWithTimestamp
|
|
latitude -
FloatWithTimestamp
|
|
longitude -
FloatWithTimestamp
|
|
direction -
FloatWithTimestamp
|
|
altitude -
FloatWithTimestamp
|
|
speed -
FloatWithTimestamp
|
|
satellites -
IntWithTimestamp
|
|
hdop -
FloatWithTimestamp
|
Example
{
"state": BooleanWithTimestamp,
"latitude": FloatWithTimestamp,
"longitude": FloatWithTimestamp,
"direction": FloatWithTimestamp,
"altitude": FloatWithTimestamp,
"speed": FloatWithTimestamp,
"satellites": IntWithTimestamp,
"hdop": FloatWithTimestamp
}
Group
Example
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"name": "xyz789",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"parentId": "daef229b-23db-4947-a472-3fbee2f43001",
"externalId": "xyz789",
"description": "xyz789",
"isOwn": false,
"vehicleIds": [
"daef229b-23db-4947-a472-3fbee2f43001"
],
"assignedVehicles": [Vehicle]
}
Ignition
Description
Ignition-related
Fields
Field Name | Description |
---|---|
engineStatus -
Boolean
|
Example
{"engineStatus": false}
IgnitionWithTimestamp
Description
Ignition-related
Fields
Field Name | Description |
---|---|
engineStatus -
BooleanWithTimestamp
|
Example
{"engineStatus": BooleanWithTimestamp}
Int
Description
The Int
scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
Example
987
IntWithTimestamp
JSON
Example
{}
Label
Example
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": true,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001"
}
LatestData
Fields
Field Name | Description |
---|---|
timestamp -
Long!
|
|
gps -
Gps
|
|
gpsWithTimestamp -
GpsWithTimestamp
|
GPS location |
odometer -
FloatWithTimestamp
|
CAN based last odometer reading |
workingHours -
FloatWithTimestamp
|
|
address -
Address
|
|
speedLimit -
SpeedLimit
|
|
geofenceData -
GeofenceData
|
|
metaSensorData -
[SensorData]
|
|
ptoHoursData -
LongWithTimestamp
|
|
driverData -
DriverData
|
|
canBus -
CanBus
|
Data items read from vehicle CAN bus |
canBusWithTimestamp -
CanBusWithTimestamp
|
Data items read from vehicle CAN bus with last timestamp |
ignition -
Ignition
|
Ignition-related |
ignitionWithTimestamp -
IgnitionWithTimestamp
|
Ignition-related with last timestamp |
driverBehaviour -
DriverBehaviour
|
Driver behaviour |
driverBehaviourWithTimestamp -
DriverBehaviourWithTimestamp
|
Driver behaviour with last timestamp |
temperatures -
Temperatures
|
Temperatures measured by sensor (degrees C) |
temperaturesWithTimestamp -
TemperaturesWithTimestamp
|
Temperatures measured by sensor (degrees C) with last timestamp |
fuel -
Fuel
|
Fuel (probe-originated) and related fields |
fuelWithTimestamp -
FuelWithTimestamp
|
Fuel (probe-originated) and related fields with last timestamp |
misc -
Misc
|
Various data items |
miscWithTimestamp -
MiscWithTimestamp
|
Various data items with timestamp |
crash -
Crash
|
Crash data. This is caused by a 'high G event'. |
crashWithTimestamp -
CrashWithTimestamp
|
Crash data with timestamp. This is caused by a 'high G event'. |
Example
{
"timestamp": {},
"gps": Gps,
"gpsWithTimestamp": GpsWithTimestamp,
"odometer": FloatWithTimestamp,
"workingHours": FloatWithTimestamp,
"address": Address,
"speedLimit": SpeedLimit,
"geofenceData": GeofenceData,
"metaSensorData": [SensorData],
"ptoHoursData": LongWithTimestamp,
"driverData": DriverData,
"canBus": CanBus,
"canBusWithTimestamp": CanBusWithTimestamp,
"ignition": Ignition,
"ignitionWithTimestamp": IgnitionWithTimestamp,
"driverBehaviour": DriverBehaviour,
"driverBehaviourWithTimestamp": DriverBehaviourWithTimestamp,
"temperatures": Temperatures,
"temperaturesWithTimestamp": TemperaturesWithTimestamp,
"fuel": Fuel,
"fuelWithTimestamp": FuelWithTimestamp,
"misc": Misc,
"miscWithTimestamp": MiscWithTimestamp,
"crash": Crash,
"crashWithTimestamp": CrashWithTimestamp
}
Long
Example
{}
LongWithTimestamp
MetaSensor
Misc
Description
Various data items
Fields
Field Name | Description |
---|---|
power -
Float
|
External power supply voltage (commonly the vehicle power system) |
Example
{"power": 123.45}
MiscWithTimestamp
Description
Various data items
Fields
Field Name | Description |
---|---|
power -
FloatWithTimestamp
|
External power supply voltage (commonly the vehicle power system) |
Example
{"power": FloatWithTimestamp}
Person
Fields
Field Name | Description |
---|---|
id -
UUID!
|
|
version -
Long!
|
|
createdAt -
Long!
|
|
updatedAt -
Long!
|
|
isDeleted -
Boolean!
|
|
isUser -
Boolean!
|
|
isDriver -
Boolean!
|
|
fleetId -
UUID!
|
|
email -
String
|
|
firstName -
String
|
|
lastName -
String
|
|
globalUserId -
String
|
|
licenseNumber -
String
|
|
licenseIssuedIn -
String
|
|
employeeId -
String
|
|
customFields -
[CustomField]
|
Example
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": true,
"isUser": true,
"isDriver": false,
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"email": "abc123",
"firstName": "xyz789",
"lastName": "abc123",
"globalUserId": "xyz789",
"licenseNumber": "abc123",
"licenseIssuedIn": "xyz789",
"employeeId": "abc123",
"customFields": [CustomField]
}
PersonInputFields
Description
The set of person input field names supported in fieldmask
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"email"
PlatformEntity
RawFuelMap
RawFuelMapWithTimestamp
Rule
Example
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"name": "xyz789",
"enabled": false,
"ruleType": "abc123",
"vehicles": RuleVehicles,
"geofenceIds": [
"daef229b-23db-4947-a472-3fbee2f43001"
]
}
RuleVehicles
Sensor
SensorData
SensorMap
SpeedLimit
String
Description
The String
scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
Example
"abc123"
StringWithTimestamp
TemperatureMap
TemperatureMapWithTimestamp
TemperatureSensorMap
TemperatureSensorMapWithTimestamp
Temperatures
Description
Temperatures measured by sensor (degrees C)
Fields
Field Name | Description |
---|---|
temperatures -
[TemperatureMap]
|
Key value map with index and temperature value |
temperatureSensorIds -
[TemperatureSensorMap]
|
Key value map with index and temperature sensor name |
Example
{
"temperatures": [TemperatureMap],
"temperatureSensorIds": [TemperatureSensorMap]
}
TemperaturesWithTimestamp
Description
Temperatures measured by sensor (degrees C)
Fields
Field Name | Description |
---|---|
temperatures -
[TemperatureMapWithTimestamp]
|
Key value map with index and temperature value |
temperatureSensorIds -
[TemperatureSensorMapWithTimestamp]
|
Key value map with index and temperature sensor name |
Example
{
"temperatures": [TemperatureMapWithTimestamp],
"temperatureSensorIds": [
TemperatureSensorMapWithTimestamp
]
}
TirePressureMap
TirePressureMapWithTimestamp
TirePressureStatusMap
TirePressureStatusMapWithTimestamp
UUID
Example
"daef229b-23db-4947-a472-3fbee2f43001"
UpdatePersonInput
Description
Person mutation parameter, containing values to be changed and field mask to enforce the changes
Example
{
"email": "abc123",
"firstName": "xyz789",
"lastName": "xyz789",
"licenseNumber": "xyz789",
"licenseIssuedIn": "xyz789",
"employeeId": "xyz789",
"isDriver": false,
"fieldMask": ["email"]
}
Vehicle
Fields
Field Name | Description |
---|---|
id -
UUID!
|
|
version -
Long!
|
|
createdAt -
Long!
|
|
updatedAt -
Long!
|
|
isDeleted -
Boolean!
|
|
name -
String
|
|
fleetId -
UUID!
|
|
vin -
String
|
|
licensePlate -
String
|
|
make -
String
|
|
model -
String
|
|
year -
Int
|
|
latestData -
LatestData
|
|
lastData -
CommonFormat
|
Use latestData instead |
assignedGroups -
[Group]
|
|
assignedDevices -
[Device]
|
List of devices, connected to a vehicle. Device details (except ID) are hidden (null) if the current user has no data access to the device. |
assignedLabels -
[Label]
|
|
lastOdometer -
Float
|
Latest odometer reading Use odometer from latestData instead |
lastWorkingHours -
Float
|
Use workingHours from latestData instead |
deactivated -
Boolean!
|
|
vehicleType -
VehicleType
|
|
customFields -
[CustomField]
|
|
workSchedule -
WorkSchedule
|
Example
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": false,
"name": "xyz789",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"vin": "xyz789",
"licensePlate": "abc123",
"make": "xyz789",
"model": "abc123",
"year": 123,
"latestData": LatestData,
"lastData": CommonFormat,
"assignedGroups": [Group],
"assignedDevices": [Device],
"assignedLabels": [Label],
"lastOdometer": 987.65,
"lastWorkingHours": 123.45,
"deactivated": true,
"vehicleType": VehicleType,
"customFields": [CustomField],
"workSchedule": WorkSchedule
}
VehicleInput
Description
Vehicle mutation parameter, containing values to be changed and field mask to enforce the changes
Fields
Input Field | Description |
---|---|
name -
String
|
|
vin -
String
|
|
licensePlate -
String
|
|
make -
String
|
|
model -
String
|
|
year -
Int
|
|
deactivated -
Boolean
|
|
vehicleTypeId -
UUID
|
|
fieldMask -
[VehicleInputFields!]!
|
A list of entity field names to specify which changes to apply for core entity. Example: [name, license_plate] |
Example
{
"name": "xyz789",
"vin": "xyz789",
"licensePlate": "abc123",
"make": "xyz789",
"model": "abc123",
"year": 123,
"deactivated": true,
"vehicleTypeId": "daef229b-23db-4947-a472-3fbee2f43001",
"fieldMask": ["name"]
}
VehicleInputFields
Description
The set of vehicle input field names supported in fieldmask
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"name"
VehicleType
WorkSchedule
Fields
Field Name | Description |
---|---|
id -
UUID!
|
|
version -
Long!
|
|
createdAt -
Long!
|
UTC, unix epoch milliseconds |
updatedAt -
Long!
|
UTC, unix epoch milliseconds |
isDeleted -
Boolean!
|
|
name -
String
|
|
fleetId -
UUID!
|
|
isDefault -
Boolean
|
Indicates that this is the fleet's default work schedule |
beginGrace -
Int
|
Begin grace period, in seconds |
endGrace -
Int
|
End grace period, in seconds |
periods -
[WorkSchedulePeriod]
|
Example
{
"id": "daef229b-23db-4947-a472-3fbee2f43001",
"version": {},
"createdAt": {},
"updatedAt": {},
"isDeleted": false,
"name": "abc123",
"fleetId": "daef229b-23db-4947-a472-3fbee2f43001",
"isDefault": false,
"beginGrace": 123,
"endGrace": 987,
"periods": [WorkSchedulePeriod]
}