> For the complete documentation index, see [llms.txt](https://motorweb.gitbook.io/motorweb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://motorweb.gitbook.io/motorweb/motorweb-reports/chassis-check-redbook-valuation.md).

# Chassis Check + RedBook Valuation

RedBook wholesale and retail values for a vehicle.

<mark style="color:green;">`GET`</mark> `https://robot.motorweb.co.nz/b2b/cc2rbv/valuation/{version}`

Returns RedBook valuation information for a vehicle. Both wholesale and retail values are returned.

### **Environments**

<table><thead><tr><th width="214" align="center">Environment</th><th>Base URL</th></tr></thead><tbody><tr><td align="center">UAT</td><td><code>https://robot.uat.motorweb.co.nz</code></td></tr><tr><td align="center">Production</td><td><code>https://robot.motorweb.co.nz</code></td></tr></tbody></table>

### **Versions**

<table><thead><tr><th width="150" align="center">Version</th><th>Notes</th></tr></thead><tbody><tr><td align="center"><strong>4.0</strong></td><td><strong>Current version.</strong></td></tr></tbody></table>

The response schema is `redbook-valuation-1.0.xsd` and does not change with the version in the path.

### **Access**

Your account must hold both the Chassis Check privilege and the RedBook valuation privilege. Without either the request returns `400` with `MotorWeb-Error-Code: BAD-ACCOUNT`.

### **Headers**

No request headers are required.

| Result  | Content type |
| ------- | ------------ |
| Success | `text/xml`   |
| Error   | `text/plain` |

### **Body**

```
< no body required >
```

### **Query Parameters**

<table><thead><tr><th width="180">Name</th><th>Value</th></tr></thead><tbody><tr><td><code>plateOrVin</code></td><td>A registration plate (6 characters or fewer) or a VIN (exactly 17 characters). Required unless you supply <code>vehicleId</code> or <code>stockNumber</code>.</td></tr><tr><td><code>vehicleId</code></td><td>The ID of a vehicle already held under your account.</td></tr><tr><td><code>stockNumber</code></td><td>Your own reference for a vehicle already held under your account.</td></tr><tr><td><code>widen</code></td><td>Optional boolean. Defaults to <code>false</code>. See below.</td></tr></tbody></table>

#### widen

* `widen=false` (default) applies the standard RedBook filter chain. If no model matches, no valuation is returned.
* `widen=true` relaxes criteria whenever a filter removes every remaining candidate. This finds a match more often, at the cost of accuracy.

### **Response**

{% tabs %}
{% tab title="200 Exact match" %}

```xml
<redbook-valuation version="1.0" vehicle-id="2169702723" billing-user="MotorWeb Development" id="2169702731" reference="7b21e4a9" timestamp="2025-10-03T15:52:10.118" user="MotorWeb Development">
    <valuation type="exact">
        <retail>
            <min-value value="31500">$31,500</min-value>
            <max-value value="34900">$34,900</max-value>
        </retail>
        <wholesale>
            <min-value value="26000">$26,000</min-value>
            <max-value value="28750">$28,750</max-value>
        </wholesale>
    </valuation>
</redbook-valuation>
```

{% endtab %}

{% tab title="200 Multiple matches" %}

```xml
<redbook-valuation version="1.0" vehicle-id="2169702723" billing-user="MotorWeb Development" id="2169702740" reference="c8043fd2" timestamp="2025-10-03T15:55:41.660" user="MotorWeb Development">
    <valuation type="multi">
        <retail>
            <min-value value="29900">$29,900</min-value>
            <max-value value="37400">$37,400</max-value>
        </retail>
        <wholesale>
            <min-value value="24500">$24,500</min-value>
            <max-value value="30900">$30,900</max-value>
        </wholesale>
    </valuation>
</redbook-valuation>
```

{% endtab %}

{% tab title="400" %}

```
There are no matching models in the RedBook database
```

or

```
There are matching RedBook models but none of them have valuation information
```

{% endtab %}
{% endtabs %}

### **Valuation types**

The `type` attribute on `valuation` tells you how confident the match is.

<table><thead><tr><th width="280">Value</th><th>Meaning</th></tr></thead><tbody><tr><td><code>exact</code></td><td>One RedBook model matched. The values apply to that model.</td></tr><tr><td><code>multi</code></td><td>Several models matched. The range spans all of them.</td></tr><tr><td><code>multiWithSomeValuesMissing</code></td><td>Several models matched but some carry no valuation. The range spans only those that do.</td></tr></tbody></table>

{% hint style="info" %}
Treat `multi` and `multiWithSomeValuesMissing` as lower confidence. The range covers more than one model, so it is wider than a true valuation for the specific vehicle.
{% endhint %}

### **XSD**

{% embed url="<https://www.motorweb.co.nz/action/robotSchema/redbook-valuation-1.0.xsd>" %}

### **Errors**

Errors return `text/plain` with the message in the body. A `MotorWeb-Error-Code` response header carries a machine-readable code.

<table><thead><tr><th width="80">HTTP</th><th width="170">Error code header</th><th>Message and cause</th></tr></thead><tbody><tr><td>400</td><td><code>BAD-PARAM</code></td><td><code>No vehicle identifiers specified</code></td></tr><tr><td>400</td><td><code>BAD-PARAM</code></td><td><code>Cannot specify both vehicleId and plateOrVin</code></td></tr><tr><td>400</td><td><code>NO-MATCH</code></td><td><code>There are no matching models in the RedBook database</code> — try <code>widen=true</code>.</td></tr><tr><td>400</td><td><code>NO-VALUATION</code></td><td><code>There are matching RedBook models but none of them have valuation information</code></td></tr><tr><td>400</td><td><code>NOT-FOUND</code></td><td><code>Vehicle not found for vehicle ID: {id}</code></td></tr><tr><td>400</td><td><code>BAD-ACCOUNT</code></td><td>Your account is missing the Chassis Check or RedBook valuation privilege.</td></tr><tr><td>400</td><td><code>MC-21</code>, <code>MC-22</code></td><td>Errors passed through from NZTA.</td></tr><tr><td>400</td><td><code>EXTERNAL-ISSUE</code></td><td>NZTA is unavailable. Check <a href="/motorweb/motorweb-reports/ping.md">Ping</a> and retry.</td></tr><tr><td>401</td><td>—</td><td>Certificate authentication failed.</td></tr></tbody></table>

**Example cURL command:**

```bash
# Production
curl --cert-type P12 --cert motorwebnz.p12:<CERTPASSWORD> \
  "https://robot.motorweb.co.nz/b2b/cc2rbv/valuation/4.0?plateOrVin=ABC123"

# With widened matching
curl --cert-type P12 --cert motorwebnz.p12:<CERTPASSWORD> \
  "https://robot.motorweb.co.nz/b2b/cc2rbv/valuation/4.0?plateOrVin=ABC123&widen=true"
```

**Notes:**

* Authentication is mutual TLS with a MotorWeb-issued client certificate
* Your account must hold both the Chassis Check and RedBook valuation privileges
* No vehicle specification data is returned, only the valuation. Use [Chassis Check + RedBook](/motorweb/motorweb-reports/chassis-check-redbook.md) if you need both
* Check the `type` attribute before you rely on the range
* To value a vehicle you already hold, see [RedBook Match and Valuation](/motorweb/additional-services/redbook-match-and-valuation.md)