RedBook Vehicle Matching and Valuation

Overview

This section provides functionality for matching vehicle details and retrieving valuation data from RedBook.

• RedBook Match: Returns a list of RedBook model codes for a vehicle with a prior MVR transaction (e.g., VIR, BVI, ChassisCheck, or Motochek). The vehicle can be identified by either vehicleId or stockNumber. Optionally, you can use a widening search algorithm.

• RedBook Valuation: Provides both wholesale and retail valuation data for a vehicle with a prior MVR transaction. The vehicle is identified by vehicleId or stockNumber.

RedBook Match

Return a list of the RedBook model codes that match the given vehicle.

RedBook Match is only available for vehicles with a MVR transaction (VIR, BVI, ChassisCheck and Motochek) already done. Use one of the following parameters to specify the vehicle to perform the RedBook match on:

• vehicleId : Retrieves the vehicle with this ID (most probably this ID will have been retrieved from a previous transaction).

• stockNumber : Retrieves the vehicle with this stock number. In the possible (but silly) case where multiple vehicles have the same stock number the vehicle that most recently had a transaction performed against it will be used.

• widen: Specify whether the RedBook matching should use the widening search algorithm (optional, default to false)

Current version: 1.0 Example URL: https://robot.motorweb.co.nz/b2b/redbook/match/fifteendigit/1.0?vehicleId=123456789

This transaction has an additional error code:

MotorWeb-Error-Code	Situation
NO-MATCH	There are no matching models in the RedBook database

The format of the text/xml response can be seen in the redbook-match-1.0.xsd schema.

RedBook Valuation

Return RedBook valuation information for the given vehicle. Both wholesale and retail values are returned.

RedBook valuation is only available for vehicles with a MVR transaction (VIR, BVI, ChassisCheck and Motochek) already done. Use one of the following parameters to specify the vehicle to perform the RedBook valuation on:

• vehicleId : Retrieves the vehicle with this ID (most probably this ID will have been retrieved from a previous transaction).

• stockNumber : Retrieves the vehicle with this stock number. In the possible (but silly) case where multiple vehicles have the same stock number the vehicle that most recently had a transaction performed against it will be used.

Current version: 1.0 Example URL: https://robot.motorweb.co.nz/b2b/redbook/valuation/1.0?vehicleId=123456789

This transaction has additional error codes:

MotorWeb-Error-Code	Situation
NO-MATCH	There are no matching models in the RedBook database
NO-VALUATION	There are matching RedBook models but none of them have valuation information

The format of the text/xml response can be seen in the redbook-valuation-1.0.xsd schema.