Sample code for 30+ languages & platforms
Node.js

UK Vehicle Data VRM Lookup

See more REST Examples

Demonstrates how to query the UK Vehicle Data VRM online API's. (See https://ukvehicledata.co.uk/)

Chilkat Node.js Downloads

Node.js
NODEJS_PRELUDE

function chilkatExample() {

    var success = false;

    //  This example requires the Chilkat API to have been previously unlocked.
    //  See Global Unlock Sample for sample code.

    var rest = new chilkat.Rest();

    //  Connect using TLS.
    var bAutoReconnect = true;
    success = rest.Connect("uk1.ukvehicledata.co.uk",443,true,bAutoReconnect);
    if (success !== true) {
        console.log(rest.LastErrorText);
        return;
    }

    //  Replace UKVD-API-KEY with your actual API KEY,
    //  which looks something like "abcdb1234-0abc-1235-abcf-1234c3d1abcd"
    rest.Authorization = "ukvd-ipwhitelist UKVD-API-KEY";

    //  Replace "ABCDE" with a real VRM...
    rest.AddQueryParam("key_vrm","ABCDE");

    //  Add the Content-Type HTTP request header.
    //  success = rest.AddHeader("Content-Type","application/json; charset=UTF-8");

    //  This request gets vehicle data.
    //  See below for a request to get battery data.
    var jsonResponseStr = rest.FullRequestNoBody("GET","/api/datapackage/vehicledata");
    if (rest.LastMethodSuccess !== true) {
        console.log(rest.LastErrorText);
        return;
    }

    if (rest.ResponseStatusCode !== 200) {
        console.log("Response Status Code = " + rest.ResponseStatusCode);
        console.log(jsonResponseStr);
        return;
    }

    var json = new chilkat.JsonObject();
    json.Load(jsonResponseStr);
    json.EmitCompact = false;

    //  Show the JSON response.
    console.log(json.Emit());

    //  A sample vehicledata response will be as shown below.
    //  To get a few bits of data from the response:
    console.log("RequestGuid: " + json.StringOf("RequestGuid"));
    console.log("EngineNumber: " + json.StringOf("DataItems.EngineNumber"));
    console.log("Vrm: " + json.StringOf("DataKeys.Vrm"));

    //  {
    //    "RequestGuid": "xxxxxxxx-cc72-4b63-xxxxxxxxxxxx",
    //    "StatusCode": 0,
    //    "StatusMessage": "Success",
    //    "PackageId": "xxxxxxxx-a4bc-4a84-af22-xxxxxxxxxxxx",
    //    "PackageVersion": 1,
    //    "DataKeys": {
    //      "Vrm": "ABCDE"
    //    },
    //    "DataItems": {
    //      "DriveAxle": "4x2",
    //      "Exported": "False",
    //      "DriverSeatPosition": "RHD",
    //      "EngineNumber": "LN910940728622",
    //      "Class": "Sport",
    //      "ImportedNorthernIreland": "False",
    //      "HistoryPreviousKeeperAcquisitionDate": "2013-01-12",
    //      "RoadFundLicenseSixMonth": "�126.50",
    //      "EnginePowerBhp": "262",
    //      "SpecDateRangeFrom": "1987-10-01",
    //      "RegistrationDateUK": "1994-08-03",
    //      "SoundLevelDriveBy": "0",
    //      "RoadFundLicenseTwelveMonth": "�235.00",
    //      "RoadFundLicenseBand": "Not available",
    //      "Vrm": "J5YVK",
    //      "TrimCode": "BA",
    //      "Derivative": "S4",
    //      "EngineSizeCc": "2174",
    //      "EngineCylinderCount": "4",
    //      "HistoryLatestV5cIssueDate": "2015-05-12",
    //      "Category": "Car",
    //      "HistoryPreviousKeeperCount": "9",
    //      "ConditionScrapped": "False",
    //      "EngineValveCount": "16",
    //      "WeightUnladen": "0",
    //      "RoadFundLicenseRenewalDate": "2017-04-01",
    //      "Model": "Esprit",
    //      "SpecDateRangeTo": "2003-06-01",
    //      "RoadFundLicenseCurrentStatus": "Tax not due",
    //      "BuildYear": "1994",
    //      "BuildDate": "1994-12-31",
    //      "VinLast4": "1448",
    //      "GearCount": "5",
    //      "SeatCount": "2",
    //      "Make": "Lotus",
    //      "Vin": "SCC082910RHA61448",
    //      "ColourChangeCount": "0",
    //      "DriveType": "Rear Wheel Drive",
    //      "WeightGross": "0",
    //      "EngineCode": "N/A",
    //      "EnginePowerKw": "193",
    //      "SoundLevelEngineSpeed": "0",
    //      "ConditionUnscrapped": "False",
    //      "HistoryPreviousKeeperDisposalDate": "2014-04-26",
    //      "EngineAlignment": "Longitudinal",
    //      "Imported": "False",
    //      "BodyType": "Coupe",
    //      "EnginePosition": "Mid",
    //      "TransmissionType": "Manual",
    //      "WeightFullyLaden": "0",
    //      "SoundLevelStationary": "0",
    //      "FuelType": "Petrol",
    //      "Colour": "YELLOW",
    //      "EngineSizeLitre": "2.2",
    //      "RegistrationDate": "1994-08-03",
    //      "Co2Emissions": "000",
    //      "WeightMaxTowingUnbraked": "0",
    //      "HistoryCurrentKeeperAcquisitionDate": "2015-04-25",
    //      "WeightMaxTowingBraked": "0",
    //      "DoorCount": "2",
    //      "EngineCylinderConfig": "Inline",
    //      "EngineFuelDelivery": "Turbo Injection"
    //    }
    //  }

    //  -----------------------------------------------------------------------------------
    //  Now get battery data...
    jsonResponseStr = rest.FullRequestNoBody("GET","/api/datapackage/batterydata");
    if (rest.LastMethodSuccess !== true) {
        console.log(rest.LastErrorText);
        return;
    }

    if (rest.ResponseStatusCode !== 200) {
        console.log("Response Status Code = " + rest.ResponseStatusCode);
        console.log(jsonResponseStr);
        return;
    }

    json.Load(jsonResponseStr);

    //  Show the JSON response containing battery data.
    console.log(json.Emit());

    //  To get a few pieces of information out of the response...
    var numBatteries = json.SizeOfArray("DataItems.BatteryList");
    var i = 0;
    while ((i < numBatteries)) {
        json.I = i;
        console.log("---- Battery " + i + ":");
        console.log("  Type = " + json.StringOf("DataItems.BatteryList[I].Type"));
        console.log("  LayoutImage = " + json.StringOf("DataItems.BatteryList[I].LayoutImage"));
        console.log("  TerminalCode = " + json.StringOf("DataItems.BatteryList[I].TerminalCode"));
        i = i+1;
    }

    //  The battery data looks like this:
    //  {
    //    "RequestGuid": "xxxxxxxx-5030-4b3d-a2ed-xxxxxxxxxxxx",
    //    "StatusCode": 0,
    //    "StatusMessage": "Success",
    //    "PackageId": "xxxxxxxx-9ec2-4fd3-9247-xxxxxxxxxxxx",
    //    "PackageVersion": 1,
    //    "DataKeys": {
    //      "Vrm": "ABCDE"
    //    },
    //    "DataItems": {
    //      "BatteryList": [
    //        {
    //          "Type": "Primary",
    //          "UkRef": "075",
    //          "LayoutCode": "0",
    //          "LayoutImage": "http://cdn.ukvehicledata.co.uk/battery/layout/0.png",
    //          "TerminalCode": "T1",
    //          "TerminalImage": "http://cdn.ukvehicledata.co.uk/battery/terminal/T1.png",
    //          "HoldDownCode": "B13",
    //          "HoldDownImage": "http://cdn.ukvehicledata.co.uk/battery/holddown/B13.png"
    //        }
    //      ],
    //      "BatteryCount": "1"
    //    }
    //  }

}

chilkatExample();