Vehicle Enquiry API v1.2.0

Interface specification for the DVLA Vehicle Enquiry API

Click here to see this OpenAPI specification in JSON format.

Base URLs

• https://driver-vehicle-licensing.api.gov.uk/vehicle-enquiry

• https://uat.driver-vehicle-licensing.api.gov.uk/vehicle-enquiry

Email: DVLA API Team

vehicle

getVehicleDetailsByRegistrationNumber

POST /v1/vehicles

Get vehicle details by registration number

Returns vehicle details based on registration number

Parameters

Name	In	Type	Required	Restrictions	Description
x-api-key	header	string	true	none	Client Specific API Key
X-Correlation-Id	header	string	false	none	Consumer Correlation ID
body	body	VehicleRequest	true	none	Registration number of the vehicle to find details for

Example Request

curl -X POST  -d '{
  "registrationNumber": "string"
}' https://driver-vehicle-licensing.api.gov.uk/vehicle-enquiry/v1/vehicles \
 -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'x-api-key: string' -H 'X-Correlation-Id: string'

Responses

Status	Meaning	Description	Schema
200	OK	Successful response	Vehicle
400	Bad Request	Bad Request	ErrorResponse
404	Not Found	Vehicle Not Found	ErrorResponse
500	Internal Server Error	Internal Server Error	ErrorResponse
503	Service Unavailable	Service Unavailable	ErrorResponse

Additional common error responses are listed in the Common Error Responses page.

Example Response

200 Response

{
  "registrationNumber": "WN67DSO",
  "taxStatus": "Untaxed",
  "taxDueDate": "2017-12-25",
  "artEndDate": "2007-12-25",
  "motStatus": "No details held by DVLA",
  "motExpiryDate": "2008-12-25",
  "make": "ROVER",
  "monthOfFirstDvlaRegistration": "2011-11",
  "monthOfFirstRegistration": "2012-12",
  "yearOfManufacture": 2004,
  "engineCapacity": 1796,
  "co2Emissions": 0,
  "fuelType": "PETROL",
  "markedForExport": true,
  "colour": "Blue",
  "typeApproval": "N1",
  "wheelplan": "NON STANDARD",
  "revenueWeight": 1640,
  "realDrivingEmissions": "1",
  "dateOfLastV5CIssued": "2016-12-25",
  "euroStatus": "Euro 5",
  "automatedVehicle": true
}

Schemas

ErrorResponse

{
  "errors": [
    {
      "status": "400",
      "code": "105",
      "title": "Invalid vrn number",
      "detail": "Invalid format for field - vehicle registration number"
    }
  ]
}

Error Response

Properties

Name	Type	Required	Restrictions	Description
errors	[Errors]	false	none	none

Errors

{
  "status": "400",
  "code": "105",
  "title": "Invalid vrn number",
  "detail": "Invalid format for field - vehicle registration number"
}

Properties

Name	Type	Required	Restrictions	Description
status	string	false	none	none
code	string	false	none	DVLA reference code
title	string	true	none	Error title
detail	string	false	none	A meaningful description of the error which has occurred

VehicleRequest

{
  "registrationNumber": "string"
}

Properties

Name	Type	Required	Restrictions	Description
registrationNumber	string	false	none	none

Vehicle

{
  "registrationNumber": "WN67DSO",
  "taxStatus": "Untaxed",
  "taxDueDate": "2017-12-25",
  "artEndDate": "2007-12-25",
  "motStatus": "No details held by DVLA",
  "motExpiryDate": "2008-12-25",
  "make": "ROVER",
  "monthOfFirstDvlaRegistration": "2011-11",
  "monthOfFirstRegistration": "2012-12",
  "yearOfManufacture": 2004,
  "engineCapacity": 1796,
  "co2Emissions": 0,
  "fuelType": "PETROL",
  "markedForExport": true,
  "colour": "Blue",
  "typeApproval": "N1",
  "wheelplan": "NON STANDARD",
  "revenueWeight": 1640,
  "realDrivingEmissions": "1",
  "dateOfLastV5CIssued": "2016-12-25",
  "euroStatus": "Euro 5",
  "automatedVehicle": true
}

Properties

Name	Type	Required	Restrictions	Description
registrationNumber	string	true	none	Registration number of the vehicle
taxStatus	string	false	Enum: Not Taxed for on Road Use,SORN,Taxed,Untaxed	Tax status of the vehicle
taxDueDate	string(date)	false	none	Date of tax liability, used in calculating licence information presented to user
artEndDate	string(date)	false	none	Additional Rate of Tax End Date, format: YYYY-MM-DD
motStatus	string	false	Enum: No details held by DVLA,No results returned,Not valid,Valid	MOT Status of the vehicle
motExpiryDate	string(date)	false	none	Mot Expiry Date
make	string	false	none	Vehicle make
monthOfFirstDvlaRegistration	string(date)	false	none	Month of First DVLA Registration
monthOfFirstRegistration	string(date)	false	none	Month of First Registration
yearOfManufacture	integer(int32)	false	none	Year of Manufacture
engineCapacity	integer(int32)	false	none	Engine capacity in cubic centimetres
co2Emissions	integer(int32)	false	none	Carbon Dioxide emissions in grams per kilometre
fuelType	string	false	none	Fuel type (Method of Propulsion)
markedForExport	boolean	false	none	True only if vehicle has been export marked
colour	string	false	none	Vehicle colour
typeApproval	string	false	none	Vehicle Type Approval Category
wheelplan	string	false	none	Vehicle wheel plan
revenueWeight	integer(int32)	false	none	Revenue weight in kilograms
realDrivingEmissions	string	false	none	Real Driving Emissions value
dateOfLastV5CIssued	string(date)	false	none	Date of last V5C issued
euroStatus	string	false	none	Euro Status (Dealer / Customer Provided (new vehicles))
automatedVehicle	boolean	false	none	Automated Vehicle (AV)

Enumerated Values

Property	Value
taxStatus	Not Taxed for on Road Use
taxStatus	SORN
taxStatus	Taxed
taxStatus	Untaxed
motStatus	No details held by DVLA
motStatus	No results returned
motStatus	Not valid
motStatus	Valid