(Objective-C) 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 Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>
#import <CkoStringBuilder.h>
#import <NSString.h>

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

CkoHttp *http = [[CkoHttp alloc] init];
BOOL success;

// 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"
// }

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"registrationNumber" value: @"ABC1234"];

[http SetRequestHeader: @"Accept" value: @"application/json"];
[http SetRequestHeader: @"x-api-key" value: @"supplied API key"];

CkoHttpResponse *resp = [http PostJson3: @"https://driver-vehicle-licensing.api.gov.uk/vehicle-enquiry/v1/vehicles" contentType: @"application/json" json: json];
if (http.LastMethodSuccess == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

CkoStringBuilder *sbResponseBody = [[CkoStringBuilder alloc] init];
[resp GetBodySb: sbResponseBody];
CkoJsonObject *jResp = [[CkoJsonObject alloc] init];
[jResp LoadSb: sbResponseBody];
jResp.EmitCompact = NO;

NSLog(@"%@",@"Response Body:");
NSLog(@"%@",[jResp Emit]);

int respStatusCode = [resp.StatusCode intValue];
NSLog(@"%@%d",@"Response Status Code = ",respStatusCode);
if (respStatusCode >= 400) {
    NSLog(@"%@",@"Response Header:");
    NSLog(@"%@",resp.Header);
    NSLog(@"%@",@"Failed.");

    return;
}

// 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

NSString *artEndDate = [jResp StringOf: @"artEndDate"];
int co2Emissions = [[jResp IntOf: @"co2Emissions"] intValue];
NSString *colour = [jResp StringOf: @"colour"];
int engineCapacity = [[jResp IntOf: @"engineCapacity"] intValue];
NSString *fuelType = [jResp StringOf: @"fuelType"];
NSString *make = [jResp StringOf: @"make"];
BOOL markedForExport = [jResp BoolOf: @"markedForExport"];
NSString *monthOfFirstRegistration = [jResp StringOf: @"monthOfFirstRegistration"];
NSString *motStatus = [jResp StringOf: @"motStatus"];
NSString *registrationNumber = [jResp StringOf: @"registrationNumber"];
int revenueWeight = [[jResp IntOf: @"revenueWeight"] intValue];
NSString *taxDueDate = [jResp StringOf: @"taxDueDate"];
NSString *taxStatus = [jResp StringOf: @"taxStatus"];
NSString *typeApproval = [jResp StringOf: @"typeApproval"];
NSString *wheelplan = [jResp StringOf: @"wheelplan"];
int yearOfManufacture = [[jResp IntOf: @"yearOfManufacture"] intValue];
NSString *euroStatus = [jResp StringOf: @"euroStatus"];
NSString *realDrivingEmissions = [jResp StringOf: @"realDrivingEmissions"];
NSString *dateOfLastV5CIssued = [jResp StringOf: @"dateOfLastV5CIssued"];