A collection of tools to work with MOT data from various of sources.
There is currently support for:
-
DVSA MOT History API via the command line interface
dvsa-mot-history-api.-
Looking up the MOT history for a single vehicle by VRM or VIN.
-
Downloading bulk data and converting to Parquet format.
-
This package uses uv to manage dependencies and installation. Make sure you install it before continuing.
To access the DVSA MOT History API, you will need to register for credentials.
You will be provided with a CLIENT_SECRET, API_KEY, SCOPE_URL, TOKEN_URL and API_URL.
These should be kept secret and placed inside a .env file at the root of this repository.
See .env.sample for an example of how that file should look.
Once you have installed uv, obtained API credientials and created a .env file, try running the following from a command line within your local copy of the repository:
uv run dvsa-mot-history-api --helpPython code for the command line interface (CLI) is stored inside src/mot_data.
Each command (for example, dvsa-mot-history-api) is stored in its own directory, with the entry points to the CLI defined in cli.py.
The commands are registered as scripts inside pyproject.toml, which causes uv to make them runnable at the command line.
Testing, type checking, linting and formatting of source code are performed using pytest, mypy and ruff.
You can run all of these automatically using:
uv run just allor to list the individual commands:
uv run just- James Thomas, Jean Golding Institute, University of Bristol
This software has been developed as part of the CARS Project, a collaboration between University of Leeds and University of Bristol and funded by ADR UK.
This software uses the DVSA MOT History API, however it is neither affialiated with nor endorsed by the DVSA or Department for Transport.
Supported by the Jean Golding Institute.
The source code in this repository is licensed under the MIT License.