Device

Introduction

A Device represents the physical tracking device installed in the vehicle. A device and vehicle is typically synonymous since the GO tracking device is installed in a vehicle. In the case where there is no device; this is represented by "NoDeviceId". The device types that are supported are:

Properties

The date the device is active from. Default [MinDate].

The date that the device is active to. Default [MaxDate].

A value indicating whether engine hours may be synthesized from vehicle active state (VAS)/ignition data instead of ECU-reported Engine Operational Time. Defaults to [null] (treated as [false]) and only takes effect when the per-device synthesized engine hours feature flag (DATAINGESTION.ALLOW_SYNTHESIZED_ENGINE_HOURS.RELEASE) is enabled. Settable on any device, but only affects device types that report engine hours (IEngineHoursProvider). Affected: the GO family (GO5–GO10, GO10 Lite, GO Legacy, Gemini, A1, U1), CustomVehicleDevice (including CellularVehicleDevice), and UntrackedAsset. Not affected: GO Anywhere, GO Anywhere Lite, CustomDevice, Bluetooth trackers, and GoDrive.

Free text field where any user information can be stored and referenced for this entity.

The device features which have been enabled whether the feature is in use (e.g. HOS, Iridium). See Device.deviceFlags for available features. Read-only; cannot be set via the API.

The DeviceFlags property cannot be added/updated via the API.

Specifies the GO or Custom DeviceType.

The list of Group(s) the device belongs to.

The unique identifier for this entity. See Id.

The name of this entity which identifies it and is used when displaying this entity. Maximum length [50].

The product id. Each device is assigned a unique hardware product id.

The Serial Number of the device. Maximum length [12].

A value indicating whether this Device supports engine hours (i.e. implements IEngineHoursProvider). The capability is derived from the concrete device type and stored independently of Device.productId, so it honours field selection: the data access layer populates it when the field is requested and clears it (to null) when it is excluded.

The IANA Timezone Id of the device used to determine local work times. This is typically the "home location" of the device. Default ["UTC"].

Retrieve a list of valid timezone Id's by querying "GetTimeZones".

The version of the entity.

The WorkTime rules to apply to the device. Default [WorkTimeStandardHours].

Rate limits

Method	Description	Limit	Period
Get	Limit of 650 Get requests per 1m.	650	1m
Set	Limit of 250 Set requests per 1m.	250	1m
Add	Limit of 250 Add requests per 1m.	250	1m
Remove	Limit of 250 Remove requests per 1m.	250	1m
GetCountOf	Limit of 250 GetCountOf requests per 1m.	250	1m
GetFeed	Limit of 250 GetFeed requests per 1m.	250	1m

Pagination

Results limit

5000

Supported sort

Name

Timeout Limit

Method	Description	Limit	Status
GetFeed		180	Active

Loading API Runner...

Device

activeFrom

activeTo

allowSynthesizedEngineHours

comment

deviceFlags

deviceType

groups

id

name

productId

serialNumber

supportsEngineHours

timeZoneId

version

workTime