The system has been built as a simple as possible RESTFUL API.
Before following this guide please Register
The API is as simple to use as calling an URL. We can test the API by going to the following URL. Clicking the below url will use our test account.
https://www.motroadtaxapi.co.uk/api/vrmlookup.php?reg=SV52ZKU&key={YOUR_KEY_HERE}Thats all there is to it!
Additional Parameters that can be passed are below, these are simply appended with a further &
Parameter | Description | Allowed Values | Default |
---|---|---|---|
reg | The full registration of the car you are looking up | Any valid registration | N/A |
key | Your unique key | Your unique key | N/A |
type | Specifies basic or advanced lookup type | basic, advanced | advanced |
format | Specifies the return format | json, serialized, array | json |
The following variables are returned for an advanced lookup
Variable | Description | Possible Results | Example |
---|---|---|---|
Has Tax | Does the car have Tax or not | Taxed, Untaxed | Taxed |
Tax Due | English representation of Tax Due date | 01 September 2017 | |
Has Mot | Does the car have Tax or not | MOT, No MOT | MOT |
Mot Due | English representation of Tax Due date | 12 January 2017 | |
Vehicle make | Confirmation of the vehicle make | AUDI | |
Date of first registration | Date when car was first registered with the DVLA | 04 September 2006 | |
Year of manufacture | Date when car was manufactured | 2006 | |
Cylinder capacity (cc) | Engine Size | 1968cc | |
CO2 Emissions | Emission Data | 154 g/km | |
Fuel type | Type of Fuel | PETROL, DIESEL | DIESEL |
Export marker | Has the car been exported | Yes, No | No |
Vehicle status | Is the Tax currently due | Tax not due, Not taxed | Tax not due |
Vehicle colour | Colour of the car | SILVER | |
Vehicle type approval | Type of car according to DVLA | M1 | |
Wheelplan | The Wheelplan of the vehicle | 2 AXLE RIGID BODY | |
Revenue weight | Weight of vehicle recorded at DVLA | Not available |
If the API is unable to retrieve the data it will return the value of ['error'] = 1.
Below is an example of a car with no valid MOT (at time of publishing).
https://www.motroadtaxapi.co.uk/api/vrmlookup.php?reg=Y58OAX&key={YOUR_KEY_HERE}Again thats all there is to it!