Table of contents

Vehicle Enquiry API v1.1.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 Description
x-api-key header string true Client Specific API Key
X-Correlation-Id header string false Consumer Correlation ID
body body VehicleRequest true 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"
}

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

Properties

Name Type Required Restrictions Description
registrationNumber string true none Registration number of the vehicle
taxStatus string false none Tax status of the vehicle
taxDueDate string(date) false none Date of tax liablity, 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 none 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))

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