> 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/current-owner-check.md).

# Current Owner Check

Basic vehicle data and the current owner. No history and no securities.

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

Returns the year, make and model of the vehicle, plus the current registered owner. Nothing else. Use it when you only need to identify who owns a vehicle.

{% hint style="info" %}
For any transaction generated more than **30 days ago**, private owner and personally identifiable information is suppressed to meet our privacy obligations. Regenerate the report to see current owner information.
{% endhint %}

### **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>

### **Paths**

<table><thead><tr><th width="360">Path</th><th>Notes</th></tr></thead><tbody><tr><td><code>/b2b/currentOwnerCheck/generate/{version}</code></td><td>Use this path. Note the capital <code>O</code> and <code>C</code>.</td></tr><tr><td><code>/action/robotCurrentOwnerCheck/{version}</code></td><td>Legacy alias. Same behaviour.</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>

{% hint style="warning" %}
The response carries `version="2.9"` on its root element and validates against `currentownercheck-2.9.xsd`. This is the schema version, and it is independent of the version in the request path. Validate against the 2.9 schema.
{% endhint %}

### **Access**

Your account must hold the Current Owner 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><tr><td><code>specificReason</code></td><td>Why private owner information is required, under section 241 of the Land Transport Act.</td></tr></tbody></table>

### **Response**

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

```xml
<current-owner-check version="2.9" vehicle-id="-321580658" billing-user="MotorWeb Development" id="-321580670" reference="e5a2c1d9" timestamp="2024-09-24T08:31:18.401" user="MotorWeb Development">
  <year-of-manufacture value="2021">2021</year-of-manufacture>
  <make>Tesla</make>
  <model>Model 3 Standard Range Plus</model>
  <mvr-model>MODEL 3</mvr-model>
  <owner current="true" owner-number="1">
    <sex-company code="M">Male</sex-company>
    <owner-name>JOE AVERAGE PUBLIC</owner-name>
    <owner-name-parts>
      <first-name>JOE</first-name>
      <middle-names>AVERAGE</middle-names>
      <last-name>PUBLIC</last-name>
    </owner-name-parts>
    <address label="Street address" usage="physical">
      <line-1>37 PUBLIC ROAD</line-1>
      <suburb>PUBLIC BAY</suburb>
      <town>AUCKLAND</town>
      <postcode>0630</postcode>
    </address>
    <address-parts usage="physical">
      <street-number>37</street-number>
      <street-name>PUBLIC ROAD</street-name>
      <suburb>PUBLIC BAY</suburb>
      <town>AUCKLAND</town>
      <post-code>0630</post-code>
    </address-parts>
    <ownership-date value="2021-09-23">23-Sep-2021</ownership-date>
    <owner-status code="C">Complete</owner-status>
  </owner>
</current-owner-check>
```

{% endtab %}

{% tab title="200 Company owner" %}

```xml
<current-owner-check version="2.9" vehicle-id="-321580659" billing-user="MotorWeb Development" id="-321580671" reference="a09b4e77" timestamp="2024-09-24T08:33:02.115" user="MotorWeb Development">
  <year-of-manufacture value="2021">2021</year-of-manufacture>
  <make>Tesla</make>
  <model>Model 3 Standard Range Plus</model>
  <mvr-model>MODEL 3</mvr-model>
  <owner current="true" owner-number="1">
    <sex-company code="C">Company</sex-company>
    <owner-name>EXAMPLE FLEET SERVICES LIMITED</owner-name>
    <owner-name-parts>
      <organisation-name>EXAMPLE FLEET SERVICES LIMITED</organisation-name>
    </owner-name-parts>
    <address label="Postal address" usage="postal">
      <line-1>PO BOX 1234</line-1>
      <town>WELLINGTON</town>
      <postcode>6011</postcode>
    </address>
    <ownership-date value="2021-09-23">23-Sep-2021</ownership-date>
    <owner-status code="C">Complete</owner-status>
    <fleet-or-lease code="F">Fleet</fleet-or-lease>
  </owner>
</current-owner-check>
```

{% endtab %}

{% tab title="200 Owner suppressed" %}

```xml
<current-owner-check version="2.9" vehicle-id="-321580660" billing-user="MotorWeb Development" id="-321580672" reference="4d81f0b2" timestamp="2024-09-24T08:35:44.902" user="MotorWeb Development">
  <year-of-manufacture value="2021">2021</year-of-manufacture>
  <make>Tesla</make>
  <model>Model 3 Standard Range Plus</model>
  <mvr-model>MODEL 3</mvr-model>
  <owner current="true" owner-number="1" suppressed-reason="OptedOut">
    <ownership-date value="2021-09-23">23-Sep-2021</ownership-date>
    <owner-status code="C">Complete</owner-status>
  </owner>
</current-owner-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="250">Element or attribute</th><th>Description</th></tr></thead><tbody><tr><td><code>owner</code></td><td>Repeats. Read <code>@current="true"</code> to find the current owner.</td></tr><tr><td><code>owner-name-parts</code></td><td>Either the individual fields (<code>first-name</code>, <code>middle-names</code>, <code>last-name</code>) or <code>organisation-name</code>. Never both.</td></tr><tr><td><code>owner/@suppressed-reason</code></td><td>Present when NZTA suppressed owner details. When present, <code>owner-name</code>, <code>sex-company</code>, <code>address</code>, <code>address-parts</code> and related elements are not returned.</td></tr><tr><td><code>address</code></td><td>Up to two per owner, distinguished by <code>@usage</code> (<code>physical</code> or <code>postal</code>).</td></tr></tbody></table>

#### suppressed-reason values

| Value                 | Meaning                                             |
| --------------------- | --------------------------------------------------- |
| `NotAuthorised`       | Your account is not authorised to see owner details |
| `UnregisteredVehicle` | The vehicle is not registered                       |
| `OptedOut`            | The owner has opted out of disclosure               |
| `PastIndividual`      | The owner is a past individual owner                |

#### sex-company codes

| Code | Meaning        |
| ---- | -------------- |
| `M`  | Male           |
| `F`  | Female         |
| `C`  | Company        |
| `I`  | Indeterminate  |
| `G`  | Gender diverse |
| `O`  | Other          |

#### owner-status codes

| Code | Meaning           |
| ---- | ----------------- |
| `C`  | Complete          |
| `D`  | In trader network |
| `I`  | Incomplete        |
| `U`  | Unconfirmed       |

### **XSD**

{% embed url="<https://www.motorweb.co.nz/action/robotSchema/currentownercheck-2.9.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 Current Owner 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>MC-23</code></td><td>Confidential owner.</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/currentOwnerCheck/generate/4.0?plateOrVin=ABC123&specificReason=state+your+specific+reason"

# UAT
curl --cert-type P12 --cert motorwebnz-uat.p12:<CERTPASSWORD> \
  "https://robot.uat.motorweb.co.nz/b2b/currentOwnerCheck/generate/4.0?plateOrVin=ABC123&specificReason=state+your+specific+reason"
```

**Notes:**

* Authentication is mutual TLS with a MotorWeb-issued client certificate
* Your account must hold the Current Owner Check privilege
* Validate against `currentownercheck-2.9.xsd`, not a `vir-*.xsd` schema
* To confirm a name or licence against the registered owner rather than retrieve it, see [Confirm Vehicle Owner](/motorweb/additional-services/confirm-vehicle-owner.md)