Cubo WS/API - Last Message

The Last Message web service allows you to integrate your own software/services with your Cubo Telamtics devices. This web service returns the last message reported by all of the devices accesible by your web service account, this will be the same time stamp that is shown on the vehicle list on your My Cubo Telemtics portal login.

API Login Credentials:
Please raise a support ticket (via clicking 'submit a request in the top right corner or via emailing fleetsupport@wearecubo.com to request credentials for your 3rd party provider to access your account. 

Please ensure you specify a name, email address, and the vehicle's or vehicle groups you wish for this account to have access too. If you are a 3rd party IT company, please ensure an authorised user on behalf of the Cubo customers raises the support ticket approving your access request.

Service URL:
http://nibcapi.isni.co/IntegrationService.svc

Service method and input parameters
GetAssetList(string userName, string password)
- userName – user name provided by Cubo support (should start with: INTG)
- password – password provided by Cubo support

Service response
- ErrorMessage - empty for successful call
- Assets – list of assets for Asset group assigned to requested username

Asset data type
- IMEI [long] – asset unique ID
- Registration [string] – Vehicle Registration number
- FriendlyName [string] – Friendly name
- Dealer [string] – Asset dealer name
- AssetType [string] – Asset type
- Icon [string] – link to Asset icon
- Active [bool] – true/false value
- Status [string] – char asset status representation
o P – parked
o D – driving
o I – idle > 2min
o X – extensively idle > 5min
- Heading [int] – numeric value from 0 to 360 direction of heading
- Location [string] – address or POI (Point Of Interest) name
- Latitude [double]
- Longitude [double]
- Speed [decimal] – kilometer per hour value
- LastUpdate [string] – unit datetime of last message in format yyyy-mm-ddThh:mm:ss
- LastReceived [string] – server received last message in format yyyy-mm-ddThh:mm:ss
- Odometer [decimal] – miles odometer value
- FuelLevel [decimal] – value from 0 to 100 percentage of fuel tank
- DigiRemainingDailyDrive [string] - 3 possible values: hh:mm, over X min or N/A
- DigiRemainingWeeklyDrive [string] - 3 possible values: hh:mm, over X min or N/A
- DigiRemainingDrive [string] - 3 possible values: hh:mm, over X min or N/A
- DigiDurationOfNextBreakRest [string] - 3 possible values: hh:mm, over X min or N/A
- DigiRemainingBreakRest [string] - 3 possible values: hh:mm, over X min or N/A
- DigiCentralTachoMessageUpdated [DateTime] – datetime of DIGI last message update
- DigiTachoSysCardNumber [string] – DIGI derived Tachograph card number
- DigiDailyDrive [string] - 3 possible values: hh:mm, over X min or N/A
- DigiTwoWeekDrive [string] - 3 possible values: hh:mm, over X min or N/A
- DigiExtendedDriveUsed [string] - 3 possible values: hh:mm, over X min or N/A
- DigiReducedRestUsed [string] - 3 possible values: hh:mm, over X min or N/A
- DigiMaximumDailyDrive [string] - 3 possible values: hh:mm, over X min or N/A
- DigiTimeLeftUntilNextDailyRest [string] - 3 possible values: hh:mm, over X min or N/A
- DigiWorkState [int]
o 0 – rest
o 1 – available
o 2 – work
o 3 – drive
- TachoWorkState [int]
o 0 – rest
o 1 – available
o 2 – work
o 3 – drive
- TachoDriverID [string] – Tachograph card number
- TachoDriverName [string] – Friendly name given to the Driver in our system
- TempTag1Name [string] – temperature tag 1 name
- TempTag1Value [decimal] – temperature tag 1 value
- TempTag2Name [string] – temperature tag 2 name
- TempTag2Value [decimal] – temperature tag 2 value
- TempTag3Name [string] – temperature tag 3 name
- TempTag3Value [decimal] – temperature tag 3 value
- TempTag4Name [string] – temperature tag 4 name
- TempTag4Value [decimal] – temperature tag 4 value
- WorkingHours [decimal] – numeric value of asset working hours (for specialist plant equipment)

Sample Response – invalid credentials

Request
http://nibcapi.isni.co/IntegrationService.svc/GetAssetList?userName=nibcapi&password=nibcapi23

Response
{
"Assets": null,
"ErrorMessage": "Login failed. Please enter valid username and password."
}

Sample request – too many requests per minute

Request
http://nibcapi.isni.co/IntegrationService.svc/GetAssetList?userName=nibcapi&password=nibcapi

Response
{
"Assets": null,
"ErrorMessage": "Last request was 3 seconds ago. Request is allowed once per
60 second period."
}

Sample request – correct request

Request
http://nibcapi.isni.co/IntegrationService.svc/GetAssetList?userName=nibcapi&password=nibcapi

Response
{
"Assets": [
{
"Active": true,
"AssetType": "Vehicle",
"Dealer": "NIBC",
"DigiCentralTachoMessageUpdated": null,
"DigiDailyDrive": "N/A",
"DigiDurationOfNextBreakRest": "N/A",
"DigiExtendedDriveUsed": "N/A",
"DigiMaximumDailyDrive": "N/A",
"DigiReducedRestUsed": "N/A",
"DigiRemainingBreakRest": "N/A",
"DigiRemainingDailyDrive": "N/A",
"DigiRemainingDrive": "N/A",
"DigiRemainingWeeklyDrive": "N/A",
"DigiTachoSysCardNumber": null,
"DigiTimeLeftUntilNextDailyRest": "N/A",
"DigiTwoWeekDrive": "N/A",
"DigiWorkState": null,
"FriendlyName": "KN13 LJK",
"FuelLevel": null,
"Heading": 66,
"IMEI": 355544064071358,
"Icon": "http://hub.nibc.co.uk/markers/CarGrey.png",
"LastReceived": "2018-02-01T23:44:51",
"LastUpdate": "2018-02-01T23:45:07",
"Latitude": 49.2915171,
"Location": "D514 , UK",
"Longitude": -0.2498626,
"Odometer": 119818.62,
"Registration": "KN13 LJK",
"Speed": 0,
"Status": "P",
"TachoDriverID": null,
"TachoDriverName": null,
"TachoWorkState": null,
"TempTag1Name": null,
"TempTag1Value": 0,
"TempTag2Name": null,
"TempTag2Value": 0,
"TempTag3Name": null,
"TempTag3Value": 0,
"TempTag4Name": null,
"TempTag4Value": null,
"WorkingHours": null
},
{
"Active": true,
"AssetType": "Vehicle",
"Dealer": "NIBC",
"DigiCentralTachoMessageUpdated": null,
"DigiDailyDrive": "N/A",
"DigiDurationOfNextBreakRest": "N/A",
"DigiExtendedDriveUsed": "N/A",
"DigiMaximumDailyDrive": "N/A",
"DigiReducedRestUsed": "N/A",
"DigiRemainingBreakRest": "N/A",
"DigiRemainingDailyDrive": "N/A",
"DigiRemainingDrive": "N/A",
"DigiRemainingWeeklyDrive": "N/A",
"DigiTachoSysCardNumber": null,
"DigiTimeLeftUntilNextDailyRest": "N/A",
"DigiTwoWeekDrive": "N/A",
"DigiWorkState": null,
"FriendlyName": "Conor Patton",
"FuelLevel": null,
"Heading": 108,
"IMEI": 355544069899662,
"Icon": "http://hub.nibc.co.uk/markers/CarBlack.png",
"LastReceived": "2018-02-01T23:11:03",
"LastUpdate": "2018-02-01T23:11:18",
"Latitude": 54.7088843,
"Location": "Greenvale Park Dale, Antrim, BT41 4 , UK",
"Longitude": -6.2080701,
"Odometer": 2291.23,
"Registration": "V555 CJP",
"Speed": 0,
"Status": "P",
"TachoDriverID": null,
"TachoDriverName": null,
"TachoWorkState": null,
"TempTag1Name": null,
"TempTag1Value": 0,
"TempTag2Name": null,
"TempTag2Value": 0,
"TempTag3Name": null,
"TempTag3Value": 0,
"TempTag4Name": null,
"TempTag4Value": null,
"WorkingHours": null
}
],
"ErrorMessage": null
}