1. Home
  2. Library
  3. Tool reference

Search New Zealand director and shareholder roles.

LiveNew Zealand1 credit

What it does

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.

Ask your AI

We are about to give this company 60-day credit. Is its director disqualified, or tied to failed companies?

What comes back

Enter a person's name as LastName FirstName for the best match; shareholder entities can also be searched.

Not disqualified. One past company in liquidation.

Disqualification
None on record
Current boards
3
Past boards
2
Liquidated
1, in 2019

Illustrative example · Checked against: Director records · Disqualified directors · Insolvency notices

Good to know

  • 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.
For developers
Tool IDnz_role_search
ServerNew Zealand
Credit behaviour1 credit

Input schema

{
  "$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
}

Shared output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "summary": {
          "type": "string"
        },
        "data": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "executionId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "creditsCharged": {
          "type": "number",
          "minimum": 0
        },
        "usage": {
          "type": "object",
          "properties": {
            "credits_charged": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "credits_remaining": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "credits_charged"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "summary",
        "data",
        "creditsCharged"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "usage": {
          "type": "object",
          "properties": {
            "credits_charged": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "credits_remaining": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "credits_charged"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

Ready to use this tool?

Connect Aroai to your AI and try a request.