VES API Test Environment

The following details can be used in the ext 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"
  }
]