API/Web Service 3rd Party Integration

If you have 3rd party services that wish to integrate with your NIBC Corcra tracking account then you can do so via our API/WS. Send this link or the attached pdf to your 3rd party providers developers to integrate the services for you.

API Login Credentials:
Please raise a support ticket (via clicking 'submit a request in the top right corner or via emailing support@nibc.co.uk) 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.

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

Service method and input parameters
GetAssetList(string userName, string password)
- userName – user name provided by NIBC / Corcra support (should start with: INTG)
- password – password provided by NIBC / Corcra 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
}