Objective-C

DVLA Vehicle Enquiry Service

See more _Miscellaneous_ Examples

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. Objective-C

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

BOOL success = NO;

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

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

// 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 = [[CkoHttpResponse alloc] init];
success = [http HttpJson: @"POST" url: @"https://driver-vehicle-licensing.api.gov.uk/vehicle-enquiry/v1/vehicles" json: json contentType: @"application/json" response: resp];
if (success == 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"];