> 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/advanced-vehicle-check.md).

# Advanced Vehicle Check

Specifications, odometer history, fuel, safety and emissions data.

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

Advanced Vehicle Check returns vehicle specification information, odometer history, and fuel, safety and emissions data. It does not return dynamic data such as WOF, COF or RUC, and it does not return owner information, plate history or security interests.

### **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>1.0</strong></td><td><strong>Current version.</strong></td></tr></tbody></table>

{% hint style="info" %}
The `vir-analysis` element inside the response carries `version="3.1"`. That is the version of the vehicle analysis block, not the version of this report. Validate the whole document against `advanced-vehicle-check-1.0.xsd`.
{% endhint %}

### **Access**

Your account must hold the Advanced Vehicle Check privilege. Without it 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></tbody></table>

{% hint style="info" %}
Advanced Vehicle Check does not return owner information, so `specificReason` is not required.
{% endhint %}

### **Response**

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

```xml
<advanced-vehicle-check vehicle-id="2157839852" billing-user="MotorWeb Team" id="2157839840" reference="2c0307a8" timestamp="2025-09-16T10:01:19.274" user="MotorWeb Team">
  <vir-analysis version="3.1">
    <vehicle>
      <registration>
        <first-registration-date-in-new-zealand value="2022-10-04">4-Oct-2022</first-registration-date-in-new-zealand>
        <registered-overseas value="false">No</registered-overseas>
      </registration>
      <year-of-manufacture value="2022">2022</year-of-manufacture>
      <make>Ford</make>
      <model>Everest Sport 3.0D/4WD/10AT</model>
      <mvr-model>EVEREST</mvr-model>
      <body-style code="SW">Wagon</body-style>
      <vehicle-type code="7">Passenger Car/Van</vehicle-type>
      <vin>MNARXXMAWRNM25032</vin>
      <engine-number>BFWS RNM25032</engine-number>
      <main-colour>WHITE</main-colour>
      <cc-rating unit="cc" value="2993">2,993</cc-rating>
      <power unit="KW" value="184">184</power>
      <country-of-origin code="THA">Thailand</country-of-origin>
      <assembly-type code="1">Imported Built-Up</assembly-type>
      <gross-vehicle-mass unit="Kg" value="3150">3,150</gross-vehicle-mass>
      <number-of-seats value="7">7</number-of-seats>
      <fuel-type code="2">Diesel</fuel-type>
      <max-rated-towed-mass-for-unbraked-trailer unit="Kg" value="750">750</max-rated-towed-mass-for-unbraked-trailer>
      <max-rated-towed-mass-for-braked-trailer unit="Kg" value="3500">3,500</max-rated-towed-mass-for-braked-trailer>
      <number-of-axles value="2">2</number-of-axles>
      <axle-type code="2">2-Axle</axle-type>
      <wheelbase unit="mm" value="2900">2,900</wheelbase>
      <vehicle-usage code="1">Private Passenger</vehicle-usage>
      <odometer-unit code="K">Km</odometer-unit>
      <odometer-reading latest="true">
        <reading value="55376">55,376</reading>
        <reading-date value="2025-09-08">8-Sep-2025</reading-date>
        <reading-unit code="K">Km</reading-unit>
        <source code="IW">Warrant of Fitness Inspection</source>
      </odometer-reading>
      <odometer-reading latest="false">
        <reading value="15">15</reading>
        <reading-date value="2022-09-27">27-Sep-2022</reading-date>
        <reading-unit code="K">Km</reading-unit>
        <source code="IW">Warrant of Fitness Inspection</source>
      </odometer-reading>
      <transmission>
        <type code="A" has-gears="true">Automatic</type>
        <speeds value="10">10</speeds>
      </transmission>
      <model-code>014938;</model-code>
      <model-variant>0</model-variant>
      <sub-model-spec>3.0D/4WD/10AT/SV/4DR/7S</sub-model-spec>
      <fuel-economy>
        <star-rating max-stars="6" value="1.5">1.5</star-rating>
        <consumption unit="litres/100Km" value="9.7">9.7</consumption>
      </fuel-economy>
      <emissions>
        <co2>
          <star-rating max-stars="6" value="1">1</star-rating>
          <quantity unit="g/Km" value="256">256</quantity>
        </co2>
        <pollutants>
          <star-rating max-stars="6" value="1">1</star-rating>
          <test-regime>EUR5</test-regime>
        </pollutants>
      </emissions>
      <safety>
        <driver>
          <test-regime>Based on 2022 ANCAP rating for 22+ models</test-regime>
        </driver>
      </safety>
      <number-of-doors value="4">4</number-of-doors>
    </vehicle>
  </vir-analysis>
</advanced-vehicle-check>
```

{% endtab %}

{% tab title="400" %}

```
No vehicle identifiers specified
```

or

```
Cannot specify both vehicleId and plateOrVin
```

{% endtab %}
{% endtabs %}

### **Fields worth noting**

<table><thead><tr><th width="220">Element</th><th>Description</th></tr></thead><tbody><tr><td><code>odometer-reading</code></td><td>Repeats. <code>@latest="true"</code> marks the most recent reading.</td></tr><tr><td><code>fuel-economy/star-rating</code></td><td>Out of 6. Half stars are possible, so the value can be fractional.</td></tr><tr><td><code>emissions/co2</code></td><td>Star rating out of 6, plus grams per kilometre.</td></tr><tr><td><code>emissions/pollutants/test-regime</code></td><td>The emissions standard the vehicle was tested against, for example <code>EUR5</code>.</td></tr><tr><td><code>safety/driver</code></td><td>Star rating and the rating regime. Either or both may be absent.</td></tr></tbody></table>

{% hint style="info" %}
The root element is `advanced-vehicle-check`. It has no `owner`, no `plate`, no `licence`, no `wof`, no `cof`, no `ruc` and no `security-interests`.
{% endhint %}

### **XSD**

{% embed url="<https://www.motorweb.co.nz/action/robotSchema/advanced-vehicle-check-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>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 does not hold the Advanced Vehicle Check 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/advancedvehiclecheck/generate/1.0?plateOrVin=ABC123"

# UAT
curl --cert-type P12 --cert motorwebnz-uat.p12:<CERTPASSWORD> \
  "https://robot.uat.motorweb.co.nz/b2b/advancedvehiclecheck/generate/1.0?plateOrVin=ABC123"
```

**Notes:**

* Authentication is mutual TLS with a MotorWeb-issued client certificate
* Your account must hold the Advanced Vehicle Check privilege
* The path is all lower case
* No owner information is returned, so `specificReason` is not required
* If you need WOF, COF, RUC or owner data, use [Motor Check](/motorweb/motorweb-reports/motor-check.md) or [VIR](/motorweb/motorweb-reports/vir.md)