1. Home
  2. Library
  3. Tool reference

Search New Zealand businesses.

LiveNew Zealand1 credit per page

What it does

Find New Zealand businesses by name, NZBN or company number. Filter by entity type, status or industry code. Full results include names, returned addresses, classifications, status dates and match details where available.

Ask your AI

Before paying a $48,000 deposit to a supplier, check the business record and show the matching name, current status, directors and any listed insolvency notices. Ask me for the supplier name if needed.

What comes back

Each page costs one credit. Use the returned cursor to continue a longer search.

Trading, with no red flags found.

Company status
Registered since 2014
Directors
2, none disqualified
Insolvency notices
None found
Filings
Up to date

Illustrative example · Checked against: Company register · Director records · Insolvency notices

Good to know

  • Each page costs one credit. Use the returned cursor to continue a longer search.
  • Results default to a concise summary. Choose standard or full for more returned details.
  • Active exact-name matches appear first. Candidate results include match details and identify shared names. Resolve the intended business before opening its full record.
  • Returned identifiers include the entity name, type and New Zealand jurisdiction. Do not infer absent fields.
For developers
Tool IDnz_company_search
ServerNew Zealand
Credit behaviour1 credit per page

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "cursor": {
      "type": "string",
      "maxLength": 200
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "entity_type": {
      "type": "string",
      "enum": [
        "B",
        "GovtCentral",
        "T",
        "D",
        "F",
        "GovtEdu",
        "I",
        "N",
        "Y",
        "Z",
        "GovtLocal",
        "COOP",
        "LTD",
        "ULTD",
        "GovtOther",
        "ASIC",
        "NON_ASIC",
        "Partnership",
        "Sole_Trader",
        "S",
        "Trading_Trust"
      ]
    },
    "entity_status": {
      "description": "Use descriptive filter values, not numeric entityStatusCode values.",
      "type": "string",
      "enum": [
        "Registered",
        "VoluntaryAdministration",
        "InReceivership",
        "InLiquidation",
        "InStatutoryAdministration",
        "Inactive",
        "RemovedClosed"
      ]
    },
    "industry_code": {
      "type": "string",
      "pattern": "^[A-Z]\\d{6}$"
    },
    "registration_date_from": {
      "description": "Include records registered on or after this date (YYYY-MM-DD). Applied to the returned page.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "registration_date_to": {
      "description": "Include records registered on or before this date (YYYY-MM-DD). Applied to the returned page.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "name_match_mode": {
      "default": "all",
      "description": "Keep all name matches, or only exact or near matches on the returned page.",
      "type": "string",
      "enum": [
        "all",
        "exact",
        "near"
      ]
    },
    "sort_by": {
      "default": "relevance",
      "description": "Sort the returned page; relevance keeps active exact-name matches first.",
      "type": "string",
      "enum": [
        "relevance",
        "name",
        "registration_date",
        "status"
      ]
    },
    "sort_order": {
      "default": "asc",
      "description": "Sort direction for name, registration date or status.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "detail": {
      "default": "summary",
      "type": "string",
      "enum": [
        "summary",
        "standard",
        "full"
      ]
    },
    "fields": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$"
      }
    }
  },
  "required": [
    "query",
    "limit",
    "name_match_mode",
    "sort_by",
    "sort_order",
    "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.