Error codes
In error scenarios, the API will return a predefined error code along with the error message and status code to give more detail on the particular error encountered.
Errors when requesting an access token may not be related to the API. In these cases, you should refer to the Microsoft Entra ID (formerly Azure Active Directory) documentation.
| Error code | Error description |
|---|---|
| MOTH-BR-01 | Something is wrong with the request |
| MOTH-UA-01 | Your authorisation failed |
| MOTH-FB-01 | You do not have permission to access this endpoint |
| MOTH-FB-02 | The access token sent with the request has expired |
| MOTH-FB-03 | The API key sent with the request is not recognised |
| MOTH-FB-04 | The access token is missing from the request |
| MOTH-RL-01 | You have exceeded your daily usage allowance |
| MOTH-RL-02 | Too many requests sent in a short time. Wait a few minutes and try again |
| MOTH-NP-01 | DVLA ID is required but has not been provided in the request |
| MOTH-NP-02 | VRM is required but has not been provided in the request |
| MOTH-NP-03 | MOT test number is required but has not been provided in the request |
| MOTH-NP-04 | Vehicle identification number is required but has not been provided in the request |
| MOTH-IV-01 | The DVLA ID provided in the request is invalid |
| MOTH-IV-02 | The MOT test number provided in the request is invalid |
| MOTH-IV-03 | The VRM provided in the request is invalid |
| MOTH-IV-04 | The vehicle identification number provided in the request is invalid |
| MOTH-NF-01 | The vehicle requested has not been found |
| MOTH-NF-02 | The URL requested has not been found |
| MOTH-PC-01 | You have reached the limit of active client secrets |
| MOTH-UN-01 | Unknown error encountered |