BVI, Asset Check and Chassis Check

Basic Vehicle Information Report

get

Generate a Basic Vehicle Information Report based on the provided registration or VIN

Query parameters
platestringOptional

Registration number/plate of the vehicle

Example: ABC123
vinstringOptional

VIN of the vehicle

Example: 1234567890ABCDEFG
Responses
200

Basic Vehicle Info Response

application/json
get
GET /v1/basic-vehicle-info HTTP/1.1
Host: 
Accept: */*

{
  "billingUser": "MotorWeb Development",
  "id": "-597768430",
  "reference": "9c29019a",
  "timestamp": "2024-04-03T13:07:09.471",
  "user": "MotorWeb Development",
  "vehicleId": "-597768395",
  "alerts": [
    {
      "description": "Warrant Of Fitness (WOF) has not been issued",
      "msgCode": "VIR-12",
      "type": "caution",
      "appliesTo": "global"
    }
  ],
  "vehicle": {
    "registration": {
      "previousCountryOfRegistration": null,
      "firstRegistrationDateInNewZealand": "2017-12-01",
      "registrationStatus": {
        "code": "A",
        "description": "Active"
      },
      "causeOfLastRegistration": "New",
      "cancellationDate": "2017-12-01",
      "cancellationReason": {
        "code": "D",
        "description": "Written off by insurer"
      },
      "registeredOverseas": false,
      "firstRegistrationDateOverseas": "2017-12-01",
      "lastRegistrationDate": "2017-12-01"
    },
    "licence": {
      "expiryDate": "2023-08-21",
      "licenceType": {
        "code": "L",
        "description": "Licence"
      },
      "issueTimestamp": "2017-12-01T12:34:00+13:00",
      "continuous": true
    },
    "wof": {
      "lastInspectionDate": "2017-12-01",
      "lastInspectionResult": {
        "code": "P",
        "description": "Pass"
      },
      "expiryDate": "2023-06-30",
      "isSubjectTo": true
    },
    "cof": {
      "lastInspectionDate": "2017-12-01",
      "lastInspectionResult": {
        "code": "P",
        "description": "Pass"
      },
      "expiryDate": "2023-06-30",
      "isSubjectTo": true
    },
    "ruc": {
      "isSubjectTo": true
    },
    "yearOfManufacture": 2022,
    "make": "Honda",
    "model": "CRV 2WD Sport 7 1.5PT",
    "mvrModel": "CRV",
    "bodyStyle": {
      "code": "UT",
      "description": "Utility"
    },
    "vehicleType": {
      "code": "7",
      "description": "Passenger Car/Van"
    },
    "vin": "1234567890ABCDEFG",
    "chassisNumber": "S14-041119",
    "engineNumber": "2G3183642",
    "mainColour": "GREY",
    "secondColour": "BLUE",
    "ccRating": {
      "unit": "cc",
      "value": 2488
    },
    "power": {
      "unit": "KW",
      "value": 132
    },
    "countryOfOrigin": {
      "code": "KOR",
      "description": "South Korea"
    },
    "assemblyType": {
      "code": "1",
      "description": "Imported Built-Up"
    },
    "grossVehicleMass": {
      "unit": "Kg",
      "value": 2240
    },
    "numberOfSeats": 5,
    "fuelType": {
      "code": "1",
      "description": "Petrol"
    },
    "alternativeFuelType": {
      "code": "3",
      "description": "CNG"
    },
    "maximumRatedTowedMassForUnbrakedTrailer": {
      "unit": "Kg",
      "value": 500
    },
    "maximumRatedTowedMassForBrakedTrailer": {
      "unit": "Kg",
      "value": 700
    },
    "tareWeight": {
      "unit": "Kg",
      "value": 2240
    },
    "numberOfAxles": 2,
    "axleType": {
      "code": "2",
      "description": "2-Axle"
    },
    "wheelbase": {
      "unit": "mm",
      "value": 3200
    },
    "frontAxleGroupRating": 3100,
    "rearAxleGroupRating": 6600,
    "vehicleUsage": {
      "code": "1",
      "description": "Private Passenger"
    },
    "odometerUnit": {
      "code": "K",
      "description": "Km"
    },
    "currentPlate": {
      "plateNumber": "ABC123",
      "plateType": {
        "code": "SI",
        "description": "Special Issue"
      },
      "effectiveDate": "2017-12-01"
    },
    "latestOdometerReading": {
      "reading": {
        "unit": "Km",
        "value": 24142
      },
      "readingDate": "2023-12-27",
      "source": {
        "code": "IW",
        "description": "Warrant of Fitness Inspection"
      }
    },
    "transmission": {
      "type": {
        "code": "A",
        "hasGears": true,
        "description": "Automatic"
      },
      "speeds": 5
    },
    "modelCode": "4081;",
    "modelVariant": "0"
  }
}

Assert Check Report

get

Generate an Asset Check Report based on the provided registration or VIN

Query parameters
platestringOptional

Registration number/plate of the vehicle

Example: ABC123
vinstringOptional

VIN of the vehicle

Example: 1234567890ABCDEFG
Responses
200

Asset Check Response

application/json
get
GET /v1/asset-check HTTP/1.1
Host: 
Accept: */*

{
  "billingUser": "MotorWeb Development",
  "id": "-597768430",
  "reference": "9c29019a",
  "timestamp": "2024-04-03T13:07:09.471",
  "user": "MotorWeb Development",
  "vehicleId": "-597768395",
  "alerts": [
    {
      "description": "Warrant Of Fitness (WOF) has not been issued",
      "msgCode": "VIR-12",
      "type": "caution",
      "appliesTo": "global"
    },
    {
      "description": "Inconsistent odometer readings - possibly around-the-clock, wound-back or human error",
      "msgCode": "VIR-26",
      "type": "caution",
      "appliesTo": "$.vehicle.odometerReadings[2]"
    }
  ],
  "fuelEconomyLabel": {
    "explanation": "Cost per year is an estimate based on petrol price of  $2.80 per litre and an average distance of 14000 km. Emissions and Energy Economy figures standardised to 3P WLTP.",
    "labelVersion": "2023(a)",
    "labelID": "V:KMHSC81DR5U991636:020424",
    "make": "HYUNDAI",
    "model": "SANTA FE",
    "subModel": "V6 GLS",
    "fuelStars": 0,
    "fuelConsumption": 12.9,
    "yearlyCost": 5060,
    "version": "1.0"
  },
  "vehicle": {
    "reportedStolen": false,
    "registration": {
      "previousCountryOfRegistration": null,
      "firstRegistrationDateInNewZealand": "2017-12-01",
      "registrationStatus": {
        "code": "A",
        "description": "Active"
      },
      "causeOfLastRegistration": "New",
      "cancellationDate": "2017-12-01",
      "cancellationReason": {
        "code": "D",
        "description": "Written off by insurer"
      },
      "registeredOverseas": false,
      "firstRegistrationDateOverseas": "2017-12-01",
      "lastRegistrationDate": "2017-12-01"
    },
    "licence": {
      "expiryDate": "2023-08-21",
      "licenceType": {
        "code": "L",
        "description": "Licence"
      },
      "issueTimestamp": "2017-12-01T12:34:00+13:00",
      "continuous": true
    },
    "wof": {
      "lastInspectionDate": "2017-12-01",
      "lastInspectionResult": {
        "code": "P",
        "description": "Pass"
      },
      "expiryDate": "2023-06-30",
      "isSubjectTo": true
    },
    "cof": {
      "lastInspectionDate": "2017-12-01",
      "lastInspectionResult": {
        "code": "P",
        "description": "Pass"
      },
      "expiryDate": "2023-06-30",
      "isSubjectTo": true
    },
    "ruc": {
      "isSubjectTo": true,
      "vehicleType": {
        "code": "1",
        "description": "Powered vehicle: 2 axles, both single tyred, any other 2-axled vehicle with a combination other than type 2 or type 299"
      },
      "issueDate": "2024-03-12",
      "rucType": {
        "code": "D",
        "description": "Distance"
      },
      "startDistance": {
        "unit": "Km",
        "value": 123456
      },
      "endDistance": {
        "unit": "Km",
        "value": 124456
      },
      "cost": {
        "unit": "per 1,000Km",
        "value": 76
      }
    },
    "yearOfManufacture": 2022,
    "make": "Honda",
    "model": "CRV 2WD Sport 7 1.5PT",
    "mvrModel": "CRV",
    "bodyStyle": {
      "code": "UT",
      "description": "Utility"
    },
    "vehicleType": {
      "code": "7",
      "description": "Passenger Car/Van"
    },
    "vin": "1234567890ABCDEFG",
    "chassisNumber": "S14-041119",
    "engineNumber": "2G3183642",
    "mainColour": "GREY",
    "secondColour": "BLUE",
    "ccRating": {
      "unit": "cc",
      "value": 2488
    },
    "power": {
      "unit": "KW",
      "value": 132
    },
    "countryOfOrigin": {
      "code": "KOR",
      "description": "South Korea"
    },
    "assemblyType": {
      "code": "1",
      "description": "Imported Built-Up"
    },
    "grossVehicleMass": {
      "unit": "Kg",
      "value": 2240
    },
    "numberOfSeats": 5,
    "fuelType": {
      "code": "1",
      "description": "Petrol"
    },
    "alternativeFuelType": {
      "code": "4",
      "description": "LPG"
    },
    "tareWeight": {
      "unit": "Kg",
      "value": 2240
    },
    "maximumRatedTowedMassForUnbrakedTrailer": {
      "unit": "Kg",
      "value": 500
    },
    "maximumRatedTowedMassForBrakedTrailer": {
      "unit": "Kg",
      "value": 700
    },
    "numberOfAxles": 2,
    "axleType": {
      "code": "2",
      "description": "2-Axle"
    },
    "wheelbase": {
      "unit": "mm",
      "value": 3200
    },
    "frontAxleGroupRating": 3100,
    "rearAxleGroupRating": 6600,
    "vehicleUsage": {
      "code": "1",
      "description": "Private Passenger"
    },
    "importedDamaged": false,
    "odometerUnit": {
      "code": "K",
      "description": "Km"
    },
    "plates": [
      {
        "plateNumber": "ABC123",
        "plateType": {
          "code": "SI",
          "description": "Special Issue"
        },
        "effectiveDate": "2017-12-01"
      }
    ],
    "odometerReadings": [
      {
        "reading": {
          "unit": "Km",
          "value": 24142
        },
        "readingDate": "2023-12-27",
        "source": {
          "code": "IW",
          "description": "Warrant of Fitness Inspection"
        }
      }
    ],
    "numberOfOwners": 7,
    "owners": [
      {
        "sexCompany": {
          "code": "F",
          "description": "Female"
        },
        "ownerName": {
          "firstName": "John",
          "middleNames": "Johnny Smithy",
          "lastName": "Smith"
        },
        "addresses": [
          {
            "poBox": "420",
            "flatNumber": "42",
            "streetNumber": "155B",
            "streetName": "FANSHAWE STREET",
            "town": "AUCKLAND",
            "postcode": "1010",
            "suburb": "AUCKLAND CBD",
            "label": "Street address",
            "usage": "physical"
          }
        ],
        "ownershipDate": "2024-04-02",
        "ownerStatus": {
          "code": "C",
          "description": "Complete"
        },
        "ownershipLength": 301,
        "ownerNumber": true,
        "tradingAsRepresenting": "MOTORWEB MOTORS",
        "jointOwner": "JANE SMITH"
      }
    ],
    "transmission": {
      "type": {
        "code": "A",
        "hasGears": true,
        "description": "Automatic"
      },
      "speeds": 5
    },
    "modelCode": "4081;",
    "modelVariant": "0",
    "fuelEconomy": {
      "starRating": {
        "maxStars": 6,
        "value": 5
      },
      "consumption": {
        "unit": "litres/100Km",
        "value": 12.9
      }
    },
    "emissions": {
      "co2": {
        "starRating": {
          "maxStars": 6,
          "value": 3
        },
        "quantity": {
          "unit": "g/Km",
          "value": 310
        }
      },
      "pollutants": {
        "starRating": {
          "maxStars": 6,
          "value": 3
        },
        "testRegime": "A79/00"
      }
    },
    "safety": {
      "driver": {
        "starRating": {
          "maxStars": 5,
          "value": 4
        },
        "testRegime": "Based on 2023 UCSR rating for 00-06 models"
      },
      "abs": true,
      "airbags": [
        "1st Row Side",
        "Driver",
        "Front Passenger"
      ],
      "tractionControl": true,
      "seatbeltLoadLimiters": true,
      "brakeAssist": true,
      "electronicBrakeForceDistribution": true,
      "lapSashSeatbelts": true,
      "rearDistanceParkControl": true
    },
    "security": {
      "factoryAlarm": true,
      "centralLocking": true,
      "engineImmobiliser": true
    },
    "numberOfDoors": 4,
    "numberOfCylinders": 6,
    "engineConfiguration": "In-line",
    "fuelDelivery": "Multi-Point Injected",
    "camDescription": "DOHC with VVT",
    "drive": "4x2",
    "induction": "Aspirated",
    "torque": {
      "unit": "Nm",
      "value": 197
    },
    "engineLocation": "Front",
    "fuelCapacity": {
      "unit": "litres",
      "value": 55
    },
    "height": {
      "unit": "mm",
      "value": 1635
    },
    "length": {
      "unit": "mm",
      "value": 4440
    },
    "frontTyreSize": "215/70 R16",
    "rearTyreSize": "215/70 R16"
  },
  "securityInterests": {
    "ignoredSecuredVehicles": "Vehicle (plate: null, vin: null, chassis: KEEFW-123456) was not searched for but returned in F62RX79218T39J05",
    "financeStatements": [
      {
        "version": "0",
        "fsNo": "FC7GNZ89T9P4B638",
        "securedPartyDetails": {
          "securedParties": [
            {
              "emailAddress": "testemail@motorweb.co.nz",
              "faxCountry": "+64",
              "faxNumber": "9 123 4567",
              "contactPhone": "9 321 6547",
              "addressDetails": {
                "addresses": [
                  {
                    "line1": "Level 3 Office Tower, Westfield Newmarket",
                    "cityTown": "Newmarket",
                    "postcode": "1010",
                    "countryCode": "NZ",
                    "type": "C"
                  }
                ]
              },
              "spOrganisation": {
                "name": "TRADEME LIMITED",
                "spPersonActing": {
                  "firstName": "John",
                  "lastName": "Smith",
                  "emailAddress": "testemail@motorweb.co.nz",
                  "faxCountry": "+64",
                  "faxNumber": "9 123 4567",
                  "addressDetails": {
                    "addresses": [
                      {
                        "line1": "Level 3 Office Tower, Westfield Newmarket",
                        "cityTown": "Newmarket",
                        "postcode": "1010",
                        "countryCode": "NZ",
                        "type": "C"
                      }
                    ]
                  }
                }
              }
            }
          ],
          "spGroup": "275"
        },
        "debtorsDetails": {
          "debtor": {
            "emailAddress": "testemail@motorweb.co.nz",
            "reference": "12345_123456",
            "addressDetails": {
              "addresses": [
                {
                  "line1": "Level 3 Office Tower, Westfield Newmarket",
                  "cityTown": "Newmarket",
                  "postcode": "1010",
                  "countryCode": "NZ",
                  "type": "C"
                }
              ]
            },
            "type": "P",
            "dbPerson": {
              "firstName": "John",
              "middleNames": "Johnny Smithy",
              "lastName": "Smith",
              "dateOfBirth": "14-11-1986"
            }
          }
        },
        "collateralDetails": {
          "collateral": {
            "collateralItems": [
              {
                "collateralItemDescription": "Hyundai Santa Fe 2005 EFY655",
                "make": "Hyundai",
                "model": "Santa FE",
                "year": "2005",
                "vin": "ABCDEFG1234567890",
                "chassis": "G6BA5257275",
                "registrationNumber": "ABC123",
                "version": "0",
                "versionDate": "2019-05-24T10:00:00.000"
              }
            ],
            "type": "MV"
          }
        },
        "fsDetails": {
          "registeredDate": "2019-05-24T10:00:32.000",
          "expiryDate": "2024-05-24T10:00:31.000"
        }
      }
    ],
    "numberOfSecurityInterests": 1
  },
  "valuation": {
    "retail": {
      "minValue": "7550.00",
      "maxValue": "7850.00"
    },
    "wholesale": {
      "minValue": "5300.00",
      "maxValue": "5500.00"
    }
  },
  "motorwebValuation": {
    "status": "OK",
    "sampleSize": 11,
    "averagePrice": "10250.00",
    "highPrice": "12100",
    "lowPrice": "8650",
    "rrpPrice": "10250",
    "listingId": "4045464553",
    "listingLink": "https://www.trademe.co.nz/4045464553",
    "listingPrice": "10000",
    "listingDate": "2023-03-18"
  },
  "numberValuationResults": 1,
  "mvrPortalApiResult": {
    "classification": "MA",
    "description": "Passenger car"
  }
}

Chassis Check Report with Redbook Codes

get

Generate a Chassis Check Report with Redbook codes based on the provided registration or VIN

Query parameters
platestringOptional

Registration number/plate of the vehicle

Example: ABC123
vinstringOptional

VIN of the vehicle

Example: 1234567890ABCDEFG
widenbooleanOptional

Widen search when no matches found

Example: false
Responses
200

Chassis Check + Redbook Response

application/json
get
GET /v1/chassis-check-plus-redbook HTTP/1.1
Host: 
Accept: */*

{
  "billingUser": "MotorWeb Development",
  "id": "-597768430",
  "reference": "9c29019a",
  "timestamp": "2024-04-03T13:07:09.471",
  "user": "MotorWeb Development",
  "vehicleId": "-597768395",
  "alerts": [
    {
      "description": "Warrant Of Fitness (WOF) has not been issued",
      "msgCode": "VIR-12",
      "type": "caution",
      "appliesTo": "global"
    }
  ],
  "vehicle": {
    "currentPlate": {
      "plateNumber": "ABC123",
      "plateType": {
        "code": "SI",
        "description": "Special Issue"
      },
      "effectiveDate": "2017-12-01"
    },
    "registration": {
      "previousCountryOfRegistration": null,
      "firstRegistrationDateInNewZealand": "2017-12-01",
      "registeredOverseas": false,
      "firstRegistrationDateOverseas": "2017-12-01"
    },
    "yearOfManufacture": 2022,
    "make": "Honda",
    "model": "CRV 2WD Sport 7 1.5PT",
    "mvrModel": "CRV",
    "bodyStyle": {
      "code": "UT",
      "description": "Utility"
    },
    "vehicleType": {
      "code": "7",
      "description": "Passenger Car/Van"
    },
    "vin": "1234567890ABCDEFG",
    "chassisNumber": "S14-041119",
    "engineNumber": "2G3183642",
    "mainColour": "GREY",
    "secondColour": "BLUE",
    "ccRating": {
      "unit": "cc",
      "value": 2488
    },
    "power": {
      "unit": "KW",
      "value": 132
    },
    "countryOfOrigin": {
      "code": "KOR",
      "description": "South Korea"
    },
    "assemblyType": {
      "code": "1",
      "description": "Imported Built-Up"
    },
    "grossVehicleMass": {
      "unit": "Kg",
      "value": 2240
    },
    "numberOfSeats": 5,
    "fuelType": {
      "code": "7",
      "description": "Petrol Hybrid"
    },
    "alternativeFuelType": {
      "code": "1",
      "description": "Petrol"
    },
    "maximumRatedTowedMassForUnbrakedTrailer": {
      "unit": "Kg",
      "value": 500
    },
    "maximumRatedTowedMassForBrakedTrailer": {
      "unit": "Kg",
      "value": 700
    },
    "tareWeight": {
      "unit": "Kg",
      "value": 2240
    },
    "numberOfAxles": 2,
    "wheelbase": {
      "unit": "text",
      "value": 1
    },
    "frontAxleGroupRating": 3100,
    "rearAxleGroupRating": 6600,
    "odometerUnit": {
      "code": "K",
      "description": "Km"
    },
    "latestOdometerReading": {
      "reading": {
        "unit": "Km",
        "value": 24142
      },
      "readingDate": "2023-12-27",
      "source": {
        "code": "IW",
        "description": "Warrant of Fitness Inspection"
      }
    },
    "transmission": {
      "type": {
        "code": "A",
        "hasGears": true,
        "description": "Automatic"
      },
      "speeds": 5
    },
    "modelCode": "4081;",
    "modelVariant": "0",
    "subModelSpec": "1.5PT/FWD/CVT/SV/5DR/7S"
  },
  "redbookCodes": [
    {
      "fifteenDigit": "NZVHOND2017AEBL",
      "eightDigit": "HOND17BL",
      "year": "2017",
      "make": "Honda",
      "family": "CRV",
      "description": "2WD Sport 7 Wagon 7st 5dr Earth Dreams 7sp 1.5T [Jun]"
    }
  ]
}
PreviousMarket OverlayNextVehicle Valuation

Last updated