Skip to main content

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

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",
  "artEndDate": "2007-12-25",
  "co2Emissions": 0,
  "engineCapacity": 1796,
  "yearOfFirstRegistration": 2012,
  "monthOfFirstRegistration": 12,
  "yearOfFirstRegistrationWithDVLA": 2012,
  "monthOfFirstRegistrationWithDVLA": 12,
  "euroStatus": "Euro 5",
  "markedAsScrapped": true,
  "markedForExport": true,
  "fuelType": "PETROL",
  "motStatus": "No details held by DVLA",
  "motExpiry": "2008-12-25",
  "revenueWeight": 1640,
  "taxDueDate": "2017-12-25",
  "taxStatus": "Untaxed",
  "colour": "Blue",
  "make": "ROVER",
  "typeApproval": "N1",
  "wheelPlan": "NON STANDARD",
  "yearOfManufacture": 2004,
  "vehicleStatus": "Not Taxed for on Road Use",
  "dateOfLastV5CIssued": "2016-12-25",
  "realDrivingEmissions": "1",
  "automatedVehicle": false
}

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",
  "artEndDate": "2007-12-25",
  "co2Emissions": 0,
  "engineCapacity": 1796,
  "yearOfFirstRegistration": 2012,
  "monthOfFirstRegistration": 12,
  "yearOfFirstRegistrationWithDVLA": 2012,
  "monthOfFirstRegistrationWithDVLA": 12,
  "euroStatus": "Euro 5",
  "markedAsScrapped": true,
  "markedForExport": true,
  "fuelType": "PETROL",
  "motStatus": "No details held by DVLA",
  "motExpiry": "2008-12-25",
  "revenueWeight": 1640,
  "taxDueDate": "2017-12-25",
  "taxStatus": "Untaxed",
  "colour": "Blue",
  "make": "ROVER",
  "typeApproval": "N1",
  "wheelPlan": "NON STANDARD",
  "yearOfManufacture": 2004,
  "vehicleStatus": "Not Taxed for on Road Use",
  "dateOfLastV5CIssued": "2016-12-25",
  "realDrivingEmissions": "1",
  "automatedVehicle": false
}

Properties

Name Type Required Restrictions Description
registrationNumber string false none Vehicle registration number without space
artEndDate string(date) false none Additional Rate of Tax Applicable until End Date
co2Emissions integer(int32) false none Carbon Dioxide emissions in grams per kilometre
engineCapacity integer(int32) false none Cylinder Capacity (CC - Engine Capacity)
yearOfFirstRegistration integer(int32) false none Year of First Registration in 4 digits
monthOfFirstRegistration integer(int32) false none Month of First Registration. 1 = Jan, 2 = Feb, etc
yearOfFirstRegistrationWithDVLA integer(int32) false none Year of First Registration With DVLA in 4 digits
monthOfFirstRegistrationWithDVLA integer(int32) false none Month of First Registration With DVLA. 1 = Jan, 2 = Feb, etc
euroStatus string false none Euro Status (Dealer / Customer Provided (new vehicles))
markedAsScrapped boolean false none Scrapped marker
markedForExport boolean false none Export marker
fuelType string false none Fuel Type (Method of Propulsion)
motStatus string false Enum: No details held by DVLA,No results returned,Valid,Not valid
 MOT status of vehicle
motExpiry string(date) false none MOT expiry date
revenueWeight integer(int32) false none Revenue Weight in kilograms
taxDueDate string(date) false none Date of tax liablity, Used in calculating licence information presented to user
taxStatus string false Enum: Not Taxed for on Road Use,SORN,Untaxed,Taxed
 Tax status of the vehicle
colour string false none Vehicle Colour
make string false none Vehicle Make
typeApproval string false none Vehicle Type Approval category
wheelPlan string false none Wheel plan
yearOfManufacture integer(int32) false none Year of Manufacture
vehicleStatus string false Enum: Not Taxed for on Road Use,SORN,Untaxed,Taxed and Due,Taxed
 Vehicle status
dateOfLastV5CIssued string(date) false none Date of last V5C issued.
realDrivingEmissions string false none Real driving emissions
automatedVehicle boolean false none Automated Vehicle

Enumerated Values

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