# New Zealand rent statistics

Preview: Compare New Zealand residential rent statistics by area, dwelling type, bedrooms and pooled period.

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

## Tool reference

MCP tool ID: `nz_market_rent`. Availability: Preview. Country: New Zealand. Credit use: 1 credit.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "area_level": {
      "type": "string",
      "enum": [
        "region",
        "territorial_authority",
        "sa2"
      ]
    },
    "place": {
      "description": "Exact place label or supported region alias; provide exactly one of place or area_code.",
      "type": "string",
      "minLength": 2,
      "maxLength": 100
    },
    "area_code": {
      "description": "Official code for the selected area level; provide exactly one of place or area_code.",
      "type": "string",
      "pattern": "^\\d{1,12}$"
    },
    "dwelling_type": {
      "default": "all",
      "type": "string",
      "enum": [
        "house",
        "apartment",
        "flat",
        "boarding_house",
        "room",
        "all"
      ]
    },
    "bedrooms": {
      "default": "all",
      "type": "string",
      "enum": [
        "1",
        "2",
        "3",
        "4",
        "5_plus",
        "unknown",
        "all"
      ]
    },
    "period_ending": {
      "description": "Pooled period end (YYYY-MM); defaults to the latest available month, two months before the current month.",
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
    },
    "num_months": {
      "default": 6,
      "type": "integer",
      "minimum": 1,
      "maximum": 24
    },
    "compare_to": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
      "description": "Pooled period end (YYYY-MM); defaults to the latest available month, two months before the current month."
    }
  },
  "required": [
    "area_level",
    "dwelling_type",
    "bedrooms",
    "num_months"
  ],
  "additionalProperties": false
}
```

## Example input

```json
{
  "area_level": "territorial_authority",
  "place": "Auckland",
  "dwelling_type": "house",
  "bedrooms": "3",
  "num_months": 6
}
```

## Usage notes

- Returns area-level rental statistics, not advertised rents or a property valuation.
- Area labels and boundaries can differ. Confirm the matched area before comparing results.
- Data is lagged and pooled across the selected period.