Skip to main content

Bulk and delta files

When you download a bulk or delta file, you’ll receive an archive file containing vehicle records as gzip compressed JSON documents. You need to decompress the documents before you can use them.

The bulk vehicle data is spread across multiple JSON files. Each file contains approximately 500,000 records. Each line represents a complete vehicle record.

An example from the bulk file:

{
  "registration": "SN97PLP",
  "registrationDate": "1973-09-21",
  "primaryColour": "Beige",
  "model": "AVENGER",
  "make": "HILLMAN",
  "fuelType": "Petrol",
  "motTests": [],
  "dataSource": "dvla",
  "last_update_date": "2023-12-04"
}
{
  "registration": "SE38GUW",
  "firstUsedDate": "2003-03-27",
  "registrationDate": "2003-03-27",
  "manufactureDate": "2003-03-27",
  "primaryColour": "Blue",
  "secondaryColour": "Not Stated",
  "engineSize": "1461",
  "model": "CLIO",
  "make": "RENAULT",
  "fuelType": "Diesel",
  "lastMotTestDate": "2017-03-10 12:21:09",
  "motTests": [
      {
          "completedDate": "2015-03-11 11:41:11",
          "expiryDate": "2016-03-10",
          "testResult": "PASSED",
          "odometerValue": "133230",
          "odometerUnit": "mi",
          "odometerResultType": "OK",
          "defects": []
      },
      {
          "completedDate": "2017-03-10 12:21:09",
          "expiryDate": "2018-03-10",
          "testResult": "PASSED",
          "odometerValue": "144392",
          "odometerUnit": "mi",
          "odometerResultType": "OK",
          "defects": [
              {
                  "dangerous": 0,
                  "text": "",
                  "type": "ADVISORY"
              },
              {
                  "dangerous": 0,
                  "text": "lens scuffed",
                  "type": "ADVISORY"
              }
          ]
      }
  ],
  "dataSource": "dvsa"
}

Delta files contain a complete record, including test history, for any vehicle which has been created, updated or deleted since the previous delta was created.

The type of change is described by the last_modification column. The possible values are:

Modification Description Example
CREATED A new vehicle has been added A new vehicle has been registered with the DVLA
UPDATED Existing information has been modified or a new test has been recorded An MOT test has been recorded against the vehicle
DELETED The vehicle has been deleted, this is not expected to occur often A vehicle was created in error and removed from the system

An example record from the delta file:

{
  "registration": "SN97PLP",
  "registrationDate": "1973-09-21",
  "primaryColour": "Beige",
  "model": "AVENGER",
  "make": "HILLMAN",
  "fuelType": "Petrol",
  "motTests": [],
  "dataSource": "dvla",
  "last_update_date": "2023-12-04",
  "last_modification": "UPDATED"
}