(Lianja) DVLA Vehicle Enquiry Service

Demonstrates how to make a call to the DVLA Vehicle Enquiry API to get vehicle details of a specified vehicle. It uses the vehicle registration number as input to search and provide details of the vehicle.

For more information, see https://developer-portal.driver-vehicle-licensing.api.gov.uk/apis/vehicle-enquiry-service/vehicle-enquiry-service-description.html

Chilkat Lianja Extension Download Chilkat Lianja Extension

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

loHttp = createobject("CkHttp")

// Implements the following CURL command:

// curl -X POST https://driver-vehicle-licensing.api.gov.uk/vehicle-enquiry/v1/vehicles \
//   -H "x-api-key: supplied API key" \
//   -H "Accept: application/json" \
//   -d '{"registrationNumber": "ABC1234"}'

// Use the following online tool to generate HTTP code from a CURL command
// Convert a cURL Command to HTTP Source Code

// Use this online tool to generate code from sample JSON:
// Generate Code to Create JSON

// The following JSON is sent in the request body.

// {
//   "registrationNumber": "ABC1234"
// }

loJson = createobject("CkJsonObject")
loJson.UpdateString("registrationNumber","ABC1234")

loHttp.SetRequestHeader("Accept","application/json")
loHttp.SetRequestHeader("x-api-key","supplied API key")

loResp = loHttp.PostJson3("https://driver-vehicle-licensing.api.gov.uk/vehicle-enquiry/v1/vehicles","application/json",loJson)
if (loHttp.LastMethodSuccess = .F.) then
    ? loHttp.LastErrorText
    release loHttp
    release loJson
    return
endif

loSbResponseBody = createobject("CkStringBuilder")
loResp.GetBodySb(loSbResponseBody)
loJResp = createobject("CkJsonObject")
loJResp.LoadSb(loSbResponseBody)
loJResp.EmitCompact = .F.

? "Response Body:"
? loJResp.Emit()

lnRespStatusCode = loResp.StatusCode
? "Response Status Code = " + str(lnRespStatusCode)
if (lnRespStatusCode >= 400) then
    ? "Response Header:"
    ? loResp.Header
    ? "Failed."
    release loResp
    release loHttp
    release loJson
    release loSbResponseBody
    release loJResp
    return
endif

release loResp

// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)

// {
//   "artEndDate": "2025-02-28",
//   "co2Emissions": 135,
//   "colour": "BLUE",
//   "engineCapacity": 2494,
//   "fuelType": "PETROL",
//   "make": "ROVER",
//   "markedForExport": false,
//   "monthOfFirstRegistration": "2004-12",
//   "motStatus": "No details held by DVLA",
//   "registrationNumber": "ABC1234",
//   "revenueWeight": 1640,
//   "taxDueDate": "2007-01-01",
//   "taxStatus": "Untaxed",
//   "typeApproval": "N1",
//   "wheelplan": "NON STANDARD",
//   "yearOfManufacture": 2004,
//   "euroStatus": "EURO 6 AD",
//   "realDrivingEmissions": "1",
//   "dateOfLastV5CIssued": "2016-12-25"
// }

// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON

lcArtEndDate = loJResp.StringOf("artEndDate")
lnCo2Emissions = loJResp.IntOf("co2Emissions")
lcColour = loJResp.StringOf("colour")
lnEngineCapacity = loJResp.IntOf("engineCapacity")
lcFuelType = loJResp.StringOf("fuelType")
lcMake = loJResp.StringOf("make")
llMarkedForExport = loJResp.BoolOf("markedForExport")
lcMonthOfFirstRegistration = loJResp.StringOf("monthOfFirstRegistration")
lcMotStatus = loJResp.StringOf("motStatus")
lcRegistrationNumber = loJResp.StringOf("registrationNumber")
lnRevenueWeight = loJResp.IntOf("revenueWeight")
lcTaxDueDate = loJResp.StringOf("taxDueDate")
lcTaxStatus = loJResp.StringOf("taxStatus")
lcTypeApproval = loJResp.StringOf("typeApproval")
lcWheelplan = loJResp.StringOf("wheelplan")
lnYearOfManufacture = loJResp.IntOf("yearOfManufacture")
lcEuroStatus = loJResp.StringOf("euroStatus")
lcRealDrivingEmissions = loJResp.StringOf("realDrivingEmissions")
lcDateOfLastV5CIssued = loJResp.StringOf("dateOfLastV5CIssued")


release loHttp
release loJson
release loSbResponseBody
release loJResp