API Documentation

For developers to programmatically perform vehicle lookups at lightning-fast speed.

Note: To request an API key: Contact us

Use the following base URL

https://api.fleetbrain.co.uk

Retrieve basic vehicle data including Tax status and MOT History

GET | POST /vehicle/basic

Argument	Description	Required
api_key	To authenticate your request	Yes
reg	The vehicle registration number	Yes

The response will be structured like the example below

{
    "Status": "SUCCESS",
    "Registration": "A1",
    "Make": "MINI",
    "Model": "COOPER S",
    "ManufactureYear": 2007,
    "Colour": "BLACK",
    "FuelType": "PETROL",
    "EngineSize": 1598,
    "ExportMarker": false,
    "Wheelplan": "2 AXLE RIGID BODY",
    "Co2Emissions": 182,
    "TypeApproval": "M1",
    "TypeApprovalDescriptor": "Passenger Car",
    "LastV5CIssueDate": "2012-06-07",
    "FirstUsedDate": "2007.05.14",
    "ManufactureDate": "2007.05.14",
    "RegistrationDate": "2007.05.14",
    "VehicleID": "TjaZviFiPVFGlrAbAfnqRQ==",
    
    "TaxSummary": {
      "IsTaxed": true,
      "IsSorn": false,
      "Title": "Taxed",
      "Subtitle": "Tax due: 2024-10-01 • 105 days",
      "TaxDate": ""
    },

    "MotSummary": {
        "ValidMot": true,
        "Title": "MOT",
        "Subtitle": "Expires: 27 Nov 2024 • 162 days",
        "MotDateString": "Expires: 27 Nov 2024",
        "MotDaysLeft": "162 days",
        "MotDate": "2024-11-27"
    },

    "MotTests": [
        {
            "TestDate": "2023.11.28 15:15:57",
            "IsTestPassed": true,
            "ExpiryDate": "2024.11.27",
            "Odometer": "3145",
            "OdometerUnit": "mi",
            "MotNumber": "431775461978",
            "OdometerResultType": "READ",
            "FailReasons": [],
            "Advisories": [],
            "RejectionReasonsAndNotes": []
        },
        {
            "TestDate": "2023.11.28 15:15:56",
            "IsTestPassed": false,
            "Odometer": "3145",
            "OdometerUnit": "mi",
            "MotNumber": "494480588824",
            "OdometerResultType": "READ",
            "FailReasons": [
                "Nearside Windscreen wiper does not clear the windscreen effectively (3.4 (b) (ii))"
            ],
            "Advisories": [],
            "RejectionReasonsAndNotes": [
                {
                    "text": "Nearside Windscreen wiper does not clear the windscreen effectively (3.4 (b) (ii))",
                    "type": "PRS",
                    "dangerous": false
                }
            ]
        },
        {
            "TestDate": "2022.11.21 15:38:22",
            "IsTestPassed": true,
            "ExpiryDate": "2023.11.20",
            "Odometer": "2805",
            "OdometerUnit": "mi",
            "MotNumber": "815329187840",
            "OdometerResultType": "READ",
            "FailReasons": [],
            "Advisories": [],
            "RejectionReasonsAndNotes": []
        },
        {
            "TestDate": "2021.10.26 09:57:01",
            "IsTestPassed": true,
            "ExpiryDate": "2022.11.20",
            "Odometer": "2080",
            "OdometerUnit": "mi",
            "MotNumber": "815648504533",
            "OdometerResultType": "READ",
            "FailReasons": [],
            "Advisories": [],
            "RejectionReasonsAndNotes": []
        },
        {
            "TestDate": "2020.11.19 11:51:28",
            "IsTestPassed": true,
            "ExpiryDate": "2021.11.20",
            "Odometer": "1914",
            "OdometerUnit": "mi",
            "MotNumber": "584327146912",
            "OdometerResultType": "READ",
            "FailReasons": [],
            "Advisories": [],
            "RejectionReasonsAndNotes": []
        },
        {
            "TestDate": "2019.11.19 15:07:26",
            "IsTestPassed": true,
            "ExpiryDate": "2020.11.20",
            "Odometer": "1560",
            "OdometerUnit": "mi",
            "MotNumber": "866039240655",
            "OdometerResultType": "READ",
            "FailReasons": [],
            "Advisories": [],
            "RejectionReasonsAndNotes": []
        },
        {
            "TestDate": "2018.11.21 11:38:46",
            "IsTestPassed": true,
            "ExpiryDate": "2019.11.20",
            "Odometer": "1065",
            "OdometerUnit": "mi",
            "MotNumber": "711249435745",
            "OdometerResultType": "READ",
            "FailReasons": [],
            "Advisories": [],
            "RejectionReasonsAndNotes": []
        },
        {
            "TestDate": "2017.11.08 10:46:39",
            "IsTestPassed": true,
            "ExpiryDate": "2018.11.07",
            "Odometer": "700",
            "OdometerUnit": "mi",
            "MotNumber": "796489278916",
            "OdometerResultType": "READ",
            "FailReasons": [],
            "Advisories": [],
            "RejectionReasonsAndNotes": []
        }
    ]
}}

Retrieve full vehicle data (not including VIN)

GET | POST /vehicle/comprehensive

Argument	Description	Required
api_key	To authenticate your request	Yes
reg	The vehicle registration number	Yes

The response will be structured like the example below

{
  "status": "success",
  "data": {
    "make": "FORD",
    "model": "FIESTA",
    "yearOfManufacture": 2022,
    "color": "Silver",
    "fuelType": "PETROL",
    "motStatus": "Valid",
    "taxStatus": "Taxed",
    "taxedUntil": "2025-03-15"
  }
}}

Retrieve comprehensive vehicle data

GET | POST /vehicle/comprehensive/vin_full

Argument	Description	Required
api_key	To authenticate your request	Yes
reg	The vehicle registration number	Yes

The response will be structured like the example below


  "status": "success",
  "data": {
    "make": "FORD",
    "model": "FIESTA",
    "yearOfManufacture": 2022,
    "color": "Silver",
    "fuelType": "PETROL",
    "motStatus": "Valid",
    "taxStatus": "Taxed",
    "taxedUntil": "2025-03-15"
  }
}