# Search New Zealand businesses

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.

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

## Tool reference

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

Credit use: 1 credit per page.

## Input schema

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

## Example input

```json
{
  "query": "Example Business",
  "limit": 10,
  "name_match_mode": "all",
  "sort_by": "relevance",
  "sort_order": "asc",
  "detail": "standard"
}
```

## Usage notes

- 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.