1. Home
  2. Library
  3. Tool reference

New Zealand business record details.

LiveNew Zealand1 credit

What it does

Review a selected New Zealand business record, including names, addresses, classifications, officer and shareholder dates, status history and related entities where available.

Ask your AI

New Zealand business record details. Ask me for any detail you need first, then show the result with its source and date, and list anything a person should check.

What comes back

The default result is an identity summary. Choose standard or full for more returned details.

Good to know

  • The default result is an identity summary. Choose standard or full for more returned details.
  • Sensitive role and shareholder addresses are omitted. Missing fields remain unknown.
  • A supported workspace key does not change the one-credit charge.
  • Public business records do not provide legal, credit or identity-verification advice.
For developers
Tool IDnz_company_get
ServerNew Zealand
Credit behaviour1 credit

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "nzbn": {
      "type": "string",
      "pattern": "^\\d{13}$"
    },
    "detail": {
      "default": "summary",
      "description": "Defaults to a short identity summary with legal name, NZBN, status and declared ultimate holding company. Use standard or full for more returned details.",
      "type": "string",
      "enum": [
        "summary",
        "standard",
        "full"
      ]
    },
    "subresources": {
      "description": "Return only these optional subresource groups alongside the identity summary. Filings and history include only fields the NZBN response supplies.",
      "maxItems": 7,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "roles",
          "shareholdings",
          "addresses",
          "trading_names",
          "industry_codes",
          "filings",
          "history"
        ]
      }
    },
    "fields": {
      "description": "Select shaped or source API fields, such as roles, company-details.shareholding or statusHistory.",
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$"
      }
    }
  },
  "required": [
    "nzbn",
    "detail"
  ],
  "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.