Guides

Units Collection

Will list all units.

URL Structure is:
https://api.trackunit.com/public/Unit

Suggest Edits

GetUnits

Columns

Refer to the following table for description of parameters:

Name

Data type

Unit of measurement

Nullability

Note

id

String

N/A

FALSE

Unique identifier.

serialNumber

String

N/A

FALSE

Unit GSM number.

phoneNumber

String

N/A

TRUE

vehicleType

String

N/A

FALSE

deviceType

String

N/A

FALSE

The model of the unit.

deviceModel

String

N/A

FALSE

The model of the unit

name

String

N/A

FALSE

displayName

String

N/A

FALSE

The full display name with category name prefixed.

referenceNumber

String

N/A

TRUE

note

String

N/A

TRUE

createdAt

DateTime

N/A

TRUE

Time of creation.

input1Name

String

N/A

TRUE

input2Name

String

N/A

TRUE

input3Name

String

N/A

TRUE

input4Name

String

N/A

TRUE

categoryId

String

N/A

TRUE

clientId

String

N/A

TRUE

keyId

String

N/A

NULL
If unit never reported it or there is no driver logged in.

gpsFixTime

DateTime

UTC time

NULL
If unit never reported valid GPS fix.

messageTime

DateTime

UTC time

NULL
If unit never reported at all.

location

Location

N/A

TRUE

altitude

Double

km

TRUE

Above sea level.

heading

Int

Degrees

TRUE

0 to 359 degrees. 0 means straight north direction, 90 - straight east etc.

speed

Double

km/h

TRUE

Current speed.

address

Address

N/A

TRUE

temperature1

Double

Celcius degrees

TRUE

Temperature sensor 1 value.

temperature2

Double

Celcius degrees

TRUE

Temperature sensor 2 value.

gsmLevel

Double

N/A

TRUE

GSM signal level.

gsmSignalQuality

String

N/A

TRUE

GSM signal quality, i.e. “Good” / “Bad”.

gpsSignalQuality

String

N/A

TRUE

GPS signal quality, i.e. “Good” / “Bad”.

batteryLevel

Double

Percent

TRUE

Internal battery level.

externalPower

Double

Volt

TRUE

External power voltage.

preRun1

Double

Seconds

FALSE

Fixed value to append to hour meter on input 1.

preRun2

Double

Seconds

TRUE

Fixed value to append to hour meter on input 2.

run1

Double

Seconds

TRUE

Hour meter to Input 1.

run2

Double

Seconds

TRUE

Hour meter to Input 2.

run3

Double

Seconds

TRUE

Hour meter to Input 3.

run4

Double

Seconds

TRUE

Hour meter to Input 4.

runOdo

Double

Km

FALSE

Hou rmeter for driving.

preKm

Double

Km

FALSE

Fixed value to append to Km.

km

Double

Km

TRUE

Total km driven.

input1

Bool

N/A

TRUE

Status of input 1.

input2

Bool

N/A

TRUE

Status of input 2.

input3

Bool

N/A

TRUE

Status of input 3.

input4

Bool

N/A

TRUE

Status of input 4.

input5

Bool

N/A

TRUE

Status of input 5.

input6

Bool

N/A

TRUE

Status of input 6.

input7

Bool

N/A

TRUE

Status of input 7.

input8

Bool

N/A

TRUE

Status of input 8.

input9

Bool

N/A

TRUE

Status of input 9.

input10

Bool

N/A

TRUE

Status of input 10.

output1

Bool

N/A

TRUE

Status of output 1.

output2

Bool

N/A

TRUE

Status of output 2.

output3

Bool

N/A

TRUE

Status of output 3.

output4

Bool

N/A

TRUE

Status of output 4.

output5

Bool

N/A

TRUE

Status of output 5.

analogInput1

Double

Volt

TRUE

Voltage on analog input 1.

analogInput2

Double

Volt

TRUE

Voltage on analog input 2.

analogInput4

Double

Volt

TRUE

Voltage on analog input 4.

input1ChangeCounter

Int

N/A

TRUE

Number of input cycles on input 1.

input2ChangeCounter

Int

N/A

TRUE

Number of input cycles on input 2.

input3ChangeCounter

Int

N/A

TRUE

Number of input cycles on input 3.

input4ChangeCounter

Int

N/A

TRUE

Number of input cycles on input 4.

isActive

Bool

N/A

FALSE

Indicates whether unit is active or inactive.

isOwn

Bool

N/A

TRUE

Indicates whether the unit is owned by customer using the API, or not.

currentStop

Double

Seconds

TRUE

Current stop time in seconds.

📘

Important

Not all of the above parameters are available for all unit types.

Request (example)

{}

Response

{
    "list": [{
        "id": "12523",
        "serialNumber": "12541",
        "phoneNumber": "4550875030",
        "vehicleType": "Car",
        "deviceType": "Trackunit",
        "deviceModel": "ME201",
        "name": "Lene",
        "displayName": "Lene",
        "note": "",
        "createdAt": "2009-01-01T00:00:00.0000000Z",
        "input1Name": "Power outlet",
        "input2Name": "Ignition",
        "input3Name": "Input 3",
        "input4Name": "Input 4",
        "gpsFixTime": "2014-08-17T14:30:17.0000000Z",
        "messageTime": "2014-08-17T14:30:17.0000000Z",
        "location": {
            "latitude": 56.1789116666667,
            "longitude": 8.73705666666667
        },
        "altitude": 0,
        "heading": 283,
        "speed": 0,
        "address": {
            "country": "DK",
            "zipCode": "7480",
            "city": "Vildbjerg",
            "streetAddress": "Trehøjevej"
        },
        "gsmLevel": 67.741935483871,
        "gsmSignalQuality": "Good",
        "externalPower": 37.082,
        "preRun1": 0,
        "preRun2": 0,
        "run1": 0,
        "run2": 39358680,
        "run3": 0,
        "run4": 0,
        "runOdo": 32068134,
        "preKm": 0,
        "km": 1402843,
        "input1": false,
        "input2": false,
        "input3": false,
        "input4": false,
        "input5": false,
        "input6": false,
        "input7": false,
        "input8": false,
        "input9": false,
        "input10": false,
        "output1": false,
        "output2": false,
        "output3": false,
        "output4": false,
        "output5": false,
        "isActive": true,
        "isOwn": false,
        "currentStop": 1389672
    }, {
        "id": "12524",
        "serialNumber": "12542",
        "phoneNumber": "4550875031",
        "vehicleType": "Car",
        "deviceType": "Trackunit",
        "deviceModel": "ME201",
        "name": "Poul",
        "displayName": "Poul",
        "note": "",
        "createdAt": "2009-01-01T00:00:00.0000000Z",
        "input1Name": "Power outlet",
        "input2Name": "Ignition",
        "input3Name": "Input 3",
        "input4Name": "Input 4",
        "gpsFixTime": "2016-04-15T12:31:43.0000000Z",
        "messageTime": "2016-04-15T12:31:43.0000000Z",
        "location": {
            "latitude": 56.1786233333333,
            "longitude": 8.73692833333333
        },
        "altitude": 0,
        "heading": 153,
        "speed": 0,
        "address": {
            "country": "DK",
            "zipCode": "7480",
            "city": "Vildbjerg",
            "streetAddress": "Møltrupvej 1"
        },
        "gsmLevel": 93.5483870967742,
        "gsmSignalQuality": "Good",
        "externalPower": 37.082,
        "preRun1": 0,
        "preRun2": 0,
        "run1": 0,
        "run2": 46509240,
        "run3": 0,
        "run4": 0,
        "runOdo": 36597393,
        "preKm": 0,
        "km": 836974,
        "input1": false,
        "input2": false,
        "input3": false,
        "input4": false,
        "input5": false,
        "input6": false,
        "input7": false,
        "input8": false,
        "input9": false,
        "input10": false,
        "output1": false,
        "output2": false,
        "output3": false,
        "output4": false,
        "output5": false,
        "isActive": true,
        "isOwn": false,
        "currentStop": 7999
    }, {
        "id": "12525",
        "serialNumber": "12543",
        "phoneNumber": "4550875032",
        "vehicleType": "Car",
        "deviceType": "Trackunit",
        "deviceModel": "ME201",
        "name": "Andreas",
        "displayName": "Andreas",
        "note": "",
        "createdAt": "2009-01-01T00:00:00.0000000Z",
        "input1Name": "Power outlet",
        "input2Name": "Ignition",
        "input3Name": "Input 3",
        "input4Name": "Input 4",
        "gpsFixTime": "2013-09-18T09:56:41.0000000Z",
        "messageTime": "2015-01-18T08:21:57.5216448Z",
        "location": {
            "latitude": 54.82387,
            "longitude": 9.32606666666667
        },
        "altitude": 0,
        "heading": 20,
        "speed": 88,
        "address": {
            "country": "DK",
            "zipCode": "6330",
            "city": "Padborg",
            "streetAddress": "Sønderjyske Motorvej"
        },
        "gsmLevel": 90.3225806451613,
        "gsmSignalQuality": "Good",
        "externalPower": 0,
        "preRun1": 0,
        "preRun2": 0,
        "run1": 0,
        "run2": 45227760,
        "run3": 0,
        "run4": 0,
        "runOdo": 39703167,
        "preKm": 0,
        "km": 1001950,
        "input1": false,
        "input2": false,
        "input3": false,
        "input4": false,
        "input5": false,
        "input6": false,
        "input7": false,
        "input8": false,
        "input9": false,
        "input10": false,
        "output1": false,
        "output2": false,
        "output3": false,
        "output4": false,
        "output5": false,
        "isActive": true,
        "isOwn": false,
        "currentStop": 72947
    }, {
        "id": "12527",
        "serialNumber": "12545",
        "phoneNumber": "4550875034",
        "vehicleType": "Car",
        "deviceType": "Trackunit",
        "deviceModel": "ME201",
        "name": "Alexander",
        "displayName": "CAT Alexander",
        "note": "",
        "createdAt": "2009-01-01T00:00:00.0000000Z",
        "input1Name": "Power outlet",
        "input2Name": "Ignition",
        "input3Name": "Input 3",
        "input4Name": "Input 4",
        "categoryId": "29646",
        "gpsFixTime": "2016-04-15T12:38:07.0000000Z",
        "messageTime": "2016-04-15T12:38:07.0000000Z",
        "location": {
            "latitude": 56.1786783333333,
            "longitude": 8.73711833333333
        },
        "altitude": 0,
        "heading": 8,
        "speed": 0,
        "address": {
            "country": "DK",
            "zipCode": "7480",
            "city": "Vildbjerg",
            "streetAddress": "Møltrupvej 1"
        },
        "gsmLevel": 100,
        "gsmSignalQuality": "Good",
        "externalPower": 37.082,
        "preRun1": 0,
        "preRun2": 0,
        "run1": 0,
        "run2": 60036840,
        "run3": 0,
        "run4": 0,
        "runOdo": 51492861,
        "preKm": 0,
        "km": 1523825,
        "input1": false,
        "input2": false,
        "input3": false,
        "input4": false,
        "input5": false,
        "input6": false,
        "input7": false,
        "input8": false,
        "input9": false,
        "input10": false,
        "output1": false,
        "output2": false,
        "output3": false,
        "output4": false,
        "output5": false,
        "isActive": true,
        "isOwn": false,
        "currentStop": 77814
    }, {
        "id": "12529",
        "serialNumber": "12547",
        "phoneNumber": "4550875036",
        "vehicleType": "Car",
        "deviceType": "Trackunit",
        "deviceModel": "ME201",
        "name": "Jonna",
        "displayName": "Jonna",
        "note": "",
        "createdAt": "2009-01-01T00:00:00.0000000Z",
        "input1Name": "Power outlet",
        "input2Name": "Ignition",
        "input3Name": "Input 3",
        "input4Name": "Input 4",
        "gpsFixTime": "2016-02-16T07:48:49.0000000Z",
        "messageTime": "2016-02-16T07:48:49.0000000Z",
        "location": {
            "latitude": 56.1254133333333,
            "longitude": 8.94063
        },
        "altitude": 0,
        "heading": 0,
        "speed": 0,
        "address": {
            "country": "DK",
            "zipCode": "7400",
            "city": "Herning",
            "streetAddress": "Mads Eg Damgaards Vej 56"
        },
        "gsmLevel": 100,
        "gsmSignalQuality": "Good",
        "externalPower": 37.661,
        "preRun1": 0,
        "preRun2": 0,
        "run1": 0,
        "run2": 65586720,
        "run3": 0,
        "run4": 0,
        "runOdo": 47023515,
        "preKm": 0,
        "km": 1035349,
        "input1": false,
        "input2": false,
        "input3": false,
        "input4": false,
        "input5": false,
        "input6": false,
        "input7": false,
        "input8": false,
        "input9": false,
        "input10": false,
        "output1": false,
        "output2": false,
        "output3": false,
        "output4": false,
        "output5": false,
        "isActive": true,
        "isOwn": false,
        "currentStop": 1028175
    }, {
        "id": "12530",
        "serialNumber": "12548",
        "phoneNumber": "4550875037",
        "vehicleType": "Car",
        "deviceType": "Trackunit",
        "deviceModel": "ME201",
        "name": "Matthias",
        "displayName": "Matthias",
        "note": "",
        "createdAt": "2009-01-01T00:00:00.0000000Z",
        "input1Name": "Strømudtag",
        "input2Name": "Tænding",
        "input3Name": "Indgang 3",
        "input4Name": "Indgang 4",
        "clientId": "34053",
        "gpsFixTime": "2016-04-15T12:30:56.0000000Z",
        "messageTime": "2016-04-15T12:30:56.0000000Z",
        "location": {
            "latitude": 57.45799,
            "longitude": 10.4853383333333
        },
        "altitude": 0,
        "heading": 0,
        "speed": 0,
        "address": {
            "country": "DK",
            "zipCode": "9900",
            "city": "Frederikshavn",
            "streetAddress": "Vendsysselvej 197"
        },
        "gsmLevel": 77.4193548387097,
        "gsmSignalQuality": "Good",
        "externalPower": 35.923,
        "preRun1": 1800000,
        "preRun2": 0,
        "run1": 0,
        "run2": 55705440,
        "run3": 0,
        "run4": 0,
        "runOdo": 38547243,
        "preKm": 10000,
        "km": 1420435,
        "input1": false,
        "input2": false,
        "input3": false,
        "input4": false,
        "input5": false,
        "input6": false,
        "input7": false,
        "input8": false,
        "input9": false,
        "input10": false,
        "output1": false,
        "output2": false,
        "output3": false,
        "output4": false,
        "output5": false,
        "isActive": true,
        "isOwn": false,
        "currentStop": 68609
    }, {
        "id": "15423",
        "serialNumber": "14846",
        "phoneNumber": "4541806265",
        "vehicleType": "Car",
        "deviceType": "Trackunit",
        "deviceModel": "ME201",
        "name": "Hanne - vogn 37",
        "displayName": "Hanne - vogn 37",
        "note": "Jacob Zimmer",
        "createdAt": "2009-01-01T00:00:00.0000000Z",
        "input1Name": "Power outlet",
        "input2Name": "Ignition",
        "input3Name": "Input 3",
        "input4Name": "Input 4",
        "gpsFixTime": "2016-04-15T12:38:28.0000000Z",
        "messageTime": "2016-04-15T12:38:28.0000000Z",
        "location": {
            "latitude": 53.0485233333333,
            "longitude": 11.3516733333333
        },
        "altitude": 0,
        "heading": 179,
        "speed": 0,
        "address": {
            "country": "DE",
            "zipCode": "29475",
            "city": "Gorleben",
            "streetAddress": "Hauptstraße 48"
        },
        "gsmLevel": 100,
        "gsmSignalQuality": "Good",
        "externalPower": 38.241,
        "preRun1": 0,
        "preRun2": 0,
        "run1": 22440,
        "run2": 31155120,
        "run3": 0,
        "run4": 0,
        "runOdo": 27648000,
        "preKm": 453793,
        "km": 448750,
        "input1": false,
        "input2": false,
        "input3": false,
        "input4": false,
        "input5": false,
        "input6": false,
        "input7": false,
        "input8": false,
        "input9": false,
        "input10": false,
        "output1": false,
        "output2": false,
        "output3": false,
        "output4": false,
        "output5": false,
        "isActive": true,
        "isOwn": false,
        "currentStop": 9855
    }, {
        "id": "15425",
        "serialNumber": "14848",
        "phoneNumber": "4541806267",
        "vehicleType": "Car",
        "deviceType": "Trackunit",
        "deviceModel": "ME201",
        "name": "Car WR 290",
        "displayName": "WR Car WR 290",
        "note": "Jacob Zimmer",
        "createdAt": "2009-01-01T00:00:00.0000000Z",
        "input1Name": "Power outlet",
        "input2Name": "Ignition",
        "input3Name": "Input 3",
        "input4Name": "Input 4",
        "categoryId": "41261",
        "gpsFixTime": "2016-04-15T12:26:16.0000000Z",
        "messageTime": "2016-04-15T12:26:16.0000000Z",
        "location": {
            "latitude": 53.0484233333333,
            "longitude": 11.3521616666667
        },
        "altitude": 0,
        "heading": 117,
        "speed": 0,
        "address": {
            "country": "DE",
            "zipCode": "29475",
            "city": "Gorleben",
            "streetAddress": "Hauptstraße 48"
        },
        "gsmLevel": 93.5483870967742,
        "gsmSignalQuality": "Good",
        "externalPower": 35.923,
        "preRun1": 0,
        "preRun2": 0,
        "run1": 226440,
        "run2": 44617320,
        "run3": 0,
        "run4": 0,
        "runOdo": 39007320,
        "preKm": 73508,
        "km": 82997,
        "input1": false,
        "input2": false,
        "input3": false,
        "input4": false,
        "input5": false,
        "input6": false,
        "input7": false,
        "input8": false,
        "input9": false,
        "input10": false,
        "output1": false,
        "output2": false,
        "output3": false,
        "output4": false,
        "output5": false,
        "isActive": true,
        "isOwn": false,
        "currentStop": 9638
    }, {
        "id": "15426",
        "serialNumber": "14849",
        "phoneNumber": "4541806268",
        "vehicleType": "Car",
        "deviceType": "Trackunit",
        "deviceModel": "ME201",
        "name": "Frederik - vogn 39",
        "displayName": "Frederik - vogn 39",
        "note": "Jacob Zimmer",
        "createdAt": "2009-01-01T00:00:00.0000000Z",
        "input1Name": "Nebenantrieb",
        "input2Name": "Zündung",
        "input3Name": "Eingang 3",
        "input4Name": "Eingang 4",
        "gpsFixTime": "2016-04-15T12:33:25.0000000Z",
        "messageTime": "2016-04-15T12:33:25.0000000Z",
        "location": {
            "latitude": 53.0484966666667,
            "longitude": 11.3521366666667
        },
        "altitude": 0,
        "heading": 349,
        "speed": 0,
        "address": {
            "country": "DE",
            "zipCode": "29475",
            "city": "Gorleben",
            "streetAddress": "Hauptstraße 48"
        },
        "gsmLevel": 93.5483870967742,
        "gsmSignalQuality": "Good",
        "externalPower": 36.502,
        "preRun1": 0,
        "preRun2": 0,
        "run1": 0,
        "run2": 46701360,
        "run3": 0,
        "run4": 0,
        "runOdo": 39199140,
        "preKm": 157,
        "km": 168231,
        "input1": false,
        "input2": false,
        "input3": false,
        "input4": false,
        "input5": false,
        "input6": false,
        "input7": false,
        "input8": false,
        "input9": false,
        "input10": false,
        "output1": false,
        "output2": false,
        "output3": false,
        "output4": false,
        "output5": false,
        "isActive": true,
        "isOwn": false,
        "currentStop": 850753
    }, {
        "id": "15428",
        "serialNumber": "14851",
        "phoneNumber": "4541806270",
        "vehicleType": "Car",
        "deviceType": "Trackunit",
        "deviceModel": "ME201",
        "name": "Car WR 234",
        "displayName": "WR Car WR 234",
        "note": "Jacob Zimmer",
        "createdAt": "2009-01-01T00:00:00.0000000Z",
        "input1Name": "Nebenantrieb",
        "input2Name": "Zündung",
        "input3Name": "Eingang 3",
        "input4Name": "Eingang 4",
        "categoryId": "41261",
        "gpsFixTime": "2016-04-15T12:40:46.0000000Z",
        "messageTime": "2016-04-15T12:40:46.0000000Z",
        "location": {
            "latitude": 51.9715083333333,
            "longitude": 11.672165
        },
        "altitude": 0,
        "heading": 346,
        "speed": 88,
        "address": {
            "country": "DE",
            "zipCode": "39221",
            "city": "Bördeland",
            "streetAddress": "E49"
        },
        "gsmLevel": 96.7741935483871,
        "gsmSignalQuality": "Good",
        "externalPower": 36.502,
        "preRun1": 0,
        "preRun2": 0,
        "run1": 77964720,
        "run2": 43485240,
        "run3": 0,
        "run4": 0,
        "runOdo": 0,
        "preKm": 372991,
        "km": 0,
        "input1": true,
        "input2": true,
        "input3": false,
        "input4": false,
        "input5": false,
        "input6": false,
        "input7": false,
        "input8": false,
        "input9": false,
        "input10": false,
        "output1": false,
        "output2": false,
        "output3": false,
        "output4": false,
        "output5": false,
        "isActive": true,
        "isOwn": false,
        "currentStop": 120250542
    }, {
        "id": "15429",
        "serialNumber": "14852",
        "phoneNumber": "4541806271",
        "vehicleType": "Car",
        "deviceType": "Trackunit",
        "deviceModel": "ME201",
        "name": "Troels - vogn 98",
        "displayName": "Troels - vogn 98",
        "note": "Jacob Zimmer",
        "createdAt": "2009-01-01T00:00:00.0000000Z",
        "input1Name": "Nebenantrieb",
        "input2Name": "Zündung",
        "input3Name": "Eingang 3",
        "input4Name": "Eingang 4",
        "gpsFixTime": "2016-04-15T12:39:58.0000000Z",
        "messageTime": "2016-04-15T12:39:58.0000000Z",
        "location": {
            "latitude": 53.048715,
            "longitude": 11.35201
        },
        "altitude": 0,
        "heading": 173,
        "speed": 0,
        "address": {
            "country": "DE",
            "zipCode": "29475",
            "city": "Gorleben",
            "streetAddress": "Ringstraße 9"
        },
        "gsmLevel": 100,
        "gsmSignalQuality": "Good",
        "externalPower": 37.082,
        "preRun1": 0,
        "preRun2": 0,
        "run1": 135960,
        "run2": 40788240,
        "run3": 0,
        "run4": 0,
        "runOdo": 33397980,
        "preKm": 828,
        "km": 381055,
        "input1": false,
        "input2": false,
        "input3": false,
        "input4": false,
        "input5": false,
        "input6": false,
        "input7": false,
        "input8": false,
        "input9": false,
        "input10": false,
        "output1": false,
        "output2": false,
        "output3": false,
        "output4": false,
        "output5": false,
        "isActive": true,
        "isOwn": false,
        "currentStop": 863
    }]
}

Updated less than a minute ago