Skip to main content

VES API Test Environment

Test VRNs

VRN Status Code
AA19AAA 200 OK
AA19EEE 200 OK
AA19PPP 200 OK
L2WPS 200 OK
AA19SRN 200 OK
AA19DSL 200 OK
AA19MOT 200 OK
AA19AMP 200 OK
ER19BAD 400 Bad Request
ER19NFD 404 Not Found
ER19THR 429 Too Many Requests
ER19ERR 500 Internal Server Error
ER19MNT 503 Service Unavailable

Successful Responses

AA19AAA (200 OK)

{
  "registrationNumber": "AA19AAA",
  "artEndDate": "2025-03-30",
  "co2Emissions": 300,
  "engineCapacity": 2000,
  "euroStatus": "EURO1",
  "markedForExport": false,
  "fuelType": "PETROL",
  "motStatus": "No details held by DVLA",
  "revenueWeight": 0,
  "colour": "RED",
  "make": "FORD",
  "typeApproval": "M1",
  "yearOfManufacture": 2019,
  "taxDueDate": "<1 YEAR FROM NOW>",
  "taxStatus": "Taxed",
  "dateOfLastV5CIssued": "2019-05-20",
  "wheelplan": "2 AXLE RIGID BODY",
  "monthOfFirstDvlaRegistration": "2019-03",
  "monthOfFirstRegistration": "2019-03",
  "realDrivingEmissions": "1"
}

AA19EEE (200 OK)

{
  "registrationNumber": "AA19EEE",
  "artEndDate": "2025-03-30",
  "co2Emissions": 200,
  "euroStatus": "EURO1",
  "markedForExport": false,
  "fuelType": "ELECTRICITY",
  "motStatus": "No results returned",
  "revenueWeight": 0,
  "colour": "RED",
  "make": "FORD",
  "typeApproval": "M1",
  "yearOfManufacture": 2019,
  "taxDueDate": "<1 YEAR FROM NOW>",
  "taxStatus": "Taxed",
  "dateOfLastV5CIssued": "2019-05-20",
  "wheelplan": "2 AXLE RIGID BODY",
  "monthOfFirstDvlaRegistration": "2019-03",
  "monthOfFirstRegistration": "2019-03"
}

AA19PPP (200 OK)

{
  "registrationNumber": "AA19PPP",
  "co2Emissions": 0,
  "engineCapacity": 2000,
  "euroStatus": "EURO6",
  "markedForExport": false,
  "fuelType": "PETROL",
  "revenueWeight": 44000,
  "colour": "RED",
  "make": "FORD",
  "yearOfManufacture": 2016,
  "taxDueDate": "<1 YEAR FROM NOW>",
  "taxStatus": "Taxed",
  "dateOfLastV5CIssued": "2019-05-20",
  "wheelplan": "3 AXLE + 3 AXLE ARTIC", 
  "monthOfFirstDvlaRegistration": "2016-09",
  "monthOfFirstRegistration": "2016-09",
  "motStatus": "Valid",
  "motExpiryDate": "<1 YEAR FROM NOW>"
}

L2WPS (200 OK)

{
  "registrationNumber": "L2WPS",
  "engineCapacity": 498,
  "markedForExport": false,
  "fuelType": "PETROL",
  "motStatus": "Not valid",
  "colour": "BLACK",
  "make": "KAWASAKI",
  "yearOfManufacture": 1994,
  "taxDueDate": "2011-05-31",
  "taxStatus": "Untaxed",
  "dateOfLastV5CIssued": "2005-05-23",
  "wheelplan": "2 WHEEL",
  "monthOfFirstRegistration": "1994-05"
}

AA19SRN (200 OK)

{
  "registrationNumber": "AA19SRN",
  "co2Emissions": 282,
  "engineCapacity": 2492,
  "markedForExport": false,
  "fuelType": "PETROL",
  "motStatus": "Not valid",
  "colour": "RED",
  "make": "ALFA ROMEO",
  "typeApproval": "M1",
  "yearOfManufacture": 2002,
  "taxStatus": "SORN",
  "dateOfLastV5CIssued": "2012-05-22",
  "motExpiryDate": "<1 YEAR FROM NOW>",
  "wheelplan": "2 AXLE RIGID BODY",
  "monthOfFirstRegistration": "2002-11"
}

AA19DSL (200 OK)

{
  "registrationNumber": "AA19DSL",
  "co2Emissions": 114,
  "engineCapacity": 1968,
  "markedForExport": false,
  "fuelType": "DIESEL",
  "motStatus": "No details held by DVLA",
  "revenueWeight": 2110,
  "colour": "GREY",
  "make": "SKODA",
  "typeApproval": "M1",
  "yearOfManufacture": 2017,
  "taxDueDate": "<1 YEAR FROM NOW>",
  "taxStatus": "Taxed",
  "dateOfLastV5CIssued": "2017-11-10",
  "wheelplan": "2 AXLE RIGID BODY",
  "monthOfFirstRegistration": "2017-11"
}

AA19MOT (200 OK)

{
  "registrationNumber":"AA19MOT",
  "co2Emissions":152,
  "engineCapacity":1984,
  "markedForExport":false,
  "fuelType":"PETROL",
  "motStatus":"Valid",
  "revenueWeight":2025,
  "colour":"WHITE",
  "make":"AUDI",
  "typeApproval":"M1",
  "yearOfManufacture":2016,
  "taxDueDate":"<1 YEAR FROM NOW>",
  "taxStatus":"Taxed",
  "dateOfLastV5CIssued":"2016-10-17",
  "motExpiryDate":"<1 YEAR FROM NOW>",
  "wheelplan":"2 AXLE RIGID BODY",
  "monthOfFirstRegistration":"2016-09"
}

AA19AMP (200 OK)

{
  "registrationNumber":"AA19AMP",
  "co2Emissions":119,
  "engineCapacity":1399,
  "markedForExport":false,
  "fuelType":"DIESEL",
  "motStatus":"Valid",
  "colour":"BLACK",
  "make":"FORD",
  "typeApproval":"M1",
  "yearOfManufacture":2008,
  "taxDueDate":"<1 YEAR FROM NOW>",
  "taxStatus":"Taxed",
  "dateOfLastV5CIssued":"2016-07-21",
  "motExpiryDate":"<1 YEAR FROM NOW>",
  "wheelplan":"2 AXLE RIGID BODY",
  "monthOfFirstRegistration":"2008-07",
  "monthOfFirstDvlaRegistration":"2009-01"
}

Error Responses

ER19BAD (400 Bad Request)

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

ER19NFD (404 Not Found)

{
  "errors": [
    {
      "status": "404",
      "code": "404",
      "title": "Vehicle Not Found",
      "detail": "Record for vehicle not found"
    }
  ]
}

ER19THR (429 Too Many Requests)

{
  "message":"Too Many Requests"
}

ER19ERR (500 Internal Server Error)

{
  "errors": [
    {
      "status": "500",
      "code": "500",
      "title": "Internal Server Error",
      "detail": "System Error occurred"
    }
  ]
}

ER19MNT (503 Service Unavailable)

[
  {
    "status": "503",
    "title": "System currently down for maintenance",
    "detail": "The service is currently down for maintenance, please contact support for more information"
  }
]