MOT Juice API

Development endpoint domain: https://api.motjuice.dev

Live endpoint domain: https://api.motjuice.co.uk

Client API

/v1/client/engagement
POST
Client-Key required - Your unique MOT Juice API key

Schema

kpi_month string optional
Format: YYYY-MM
Default: Current month
Specify a particular month for which the data is required.

exclude_external_training boolean optional
Default: false
Specify whether the DVSA and CPD training progress should exclude any "external" training not provided by MOT Juice.

vts_id array optional
Default: all subscribed VTS
Array of VTS IDs to return.

Example

{
    "kpi_month" : "2023-02",
    "exclude_external_training" : true,
    "vts_id" : [
        "ABC00001",
        "VID12345"
    ]
}
                                

200 OK
400 Bad Request
403 Forbidden
404 Not Found
405 Method Not Allowed
500 Internal Server Error

A successful response body contains an array of JSON data for each VTS. Each value ranges from 0 - 100, the percentage of completion.

Example

[
    {
        "vts_id": "ABC00001",
        "name": "ABC Garage",
        "tester_first_login": 100,
        "garage_first_login": 100,
        "tester_logins": 75,
        "garage_logins": 0,
        "tester_bootcamp": 53,
        "garage_bootcamp": 0,
        "dvsa_started": 100,
        "cpd_started": 100,
        "dvsa_ontrack": 75,
        "cpd_ontrack": 0,
        "exam_passed": 0,
        "tqi_reviewed": 0,
        "qc_checks": 25,
        "audits": 0,
        "tla_reviewed": 0,
        "calibrations": 90,
        "invoice_cross_checks": 0
    },
    {
        "vts_id": "VID12345",
        "name": "MOT Garage Ltd",
        "tester_first_login": 100,
        "garage_first_login": 100,
        "tester_logins": 80,
        "garage_logins": 67,
        "tester_bootcamp": 0,
        "garage_bootcamp": 0,
        "dvsa_started": 100,
        "cpd_started": 100,
        "dvsa_ontrack": 100,
        "cpd_ontrack": 40,
        "exam_passed": 80,
        "tqi_reviewed": 30,
        "qc_checks": 80,
        "audits": 100,
        "tla_reviewed": 100,
        "calibrations": 100,
        "invoice_cross_checks": 100
    }
]
                                
/v1/client/orderFulfilment
POST
Client-Key required - Your unique MOT Juice API key

Schema

Garage object required

Garage Name string required

Garage Address 1 string required

Garage Address 2 string optional

Garage Town string required

Garage County string required

Garage Postcode string required

Garage Main Tel string required

Garage Mot Class 1 boolean optional Default: false

Garage Mot Class 2 boolean optional Default: false

Garage Mot Class 3 boolean optional Default: false

Garage Mot Class 4 boolean optional Default: false

Garage Mot Class 5 boolean optional Default: false

Garage Mot Class 7 boolean optional Default: false

Garage Contact First Name string required

Garage Contact Last Name string required

Garage Contact Tel Land string required

Garage Contact Email string required

Tester Count integer required
The number of paid testers for supplying training and exams

CPD boolean required
Set to true if supplying the testers with annual CPD

Training boolean required
Set to true if supplying the testers with annual training

Exam boolean required
Set to true if supplying the testers with annual exams

Example

{
    "Garage":{
          "Garage Name": "ABC Ltd",
          "Garage Address 1": "123 A Street",
          "Garage Address 2": "",
          "Garage Town": "The Town",
          "Garage County": "Some County",
          "Garage Postcode": "RH1 1HR",
          "Garage Main Tel": "01233111222",
          "Garage Mot Class 1": true,
          "Garage Mot Class 2": true,
          "Garage Mot Class 3": false,
          "Garage Mot Class 4": true,
          "Garage Mot Class 5": true,
          "Garage Mot Class 7": false,
          "Garage Contact First Name": "Bob",
          "Garage Contact Last Name": "Smith",
          "Garage Contact Tel Land": "01222333222",
          "Garage Contact Email": "test@test.com"
    },
    "Tester Count": 3,
    "CPD": true,
    "Training": true,
    "Exam": true
}
                                

200 OK
400 Bad Request
403 Forbidden
404 Not Found
405 Method Not Allowed
500 Internal Server Error