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.
| 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 |