# Search New Zealand director and shareholder roles

Find company roles connected with a person or shareholder entity in New Zealand public business records. Review the returned companies and match details before following up.

Canonical: https://aroai.com/tools/nz_role_search/

## Tool reference

MCP tool ID: `nz_role_search`. Availability: Live. Country: New Zealand.

Credit use: 1 credit.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Person or shareholder entity name; LastName FirstName is recommended for a person."
    },
    "role_type": {
      "default": "any",
      "type": "string",
      "enum": [
        "director",
        "shareholder",
        "any"
      ]
    },
    "active_only": {
      "default": false,
      "description": "Keep people with an active role in at least one registered company. MBIE may still return their other company roles.",
      "type": "boolean"
    },
    "page": {
      "default": 0,
      "description": "Zero-based result page (0–10000).",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "page_size": {
      "default": 20,
      "description": "Results per page (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "name",
    "role_type",
    "active_only",
    "page",
    "page_size"
  ],
  "additionalProperties": false
}
```

## Example input

```json
{
  "name": "Smith Jane",
  "role_type": "director",
  "active_only": false,
  "page": 0,
  "page_size": 20
}
```

## Usage notes

- Enter a person's name as LastName FirstName for the best match; shareholder entities can also be searched.
- The active-only filter can still return other non-active roles for a person with at least one active role.
- The result includes the company number or NZBN; use nz_company_get for full company details.
- A role or shareholding entry does not prove beneficial or sole ownership. A no-match result is not clearance.