NEW ZEALAND · DEVELOPER DOCUMENTATION

Build on the NZ property graph.

Addresses, primary parcels, title relationships, coordinate resolution and source-aware geospatial intelligence through one production PropData contract.

Overview

PropData New Zealand normalizes authoritative New Zealand property-source layers into a country-aware property contract. The current national graph contains 3,040,571 primary parcels, 2,424,415 authoritative addresses, 2,450,998 property titles, and 2,988,279 title↔parcel associations. The LINZ building-outline baseline targets 3,268,141 outlines and is actively loading as a separate enrichment layer.

ADDRESS → PRIMARY PARCEL → PARCEL GEOMETRY → PROPERTY TITLES → TITLE RELATIONSHIPS → BUILDING OUTLINES → PROPERTY INTELLIGENCE
The address, parcel, title and title↔parcel baselines are nationally complete. Building-outline population and graph linkage remain coverage-aware while the national enrichment baseline finishes.

Quick start

Use country=NZ on New Zealand property requests.

Address

GET /v1/property?country=NZ&address=221%2F66%20Mabey%20Road%2C%20Avalon%2C%20Lower%20Hutt

Primary parcel

GET /v1/property?country=NZ&parcel=3818618

Coordinates

GET /v1/property/by-location?country=NZ&lat=-41.1886269490596&lng=174.943031500008

The Mabey Road record is a verified production-graph canary: address ID 2064090, primary parcel 3818618, appellation Lot 1 DP 90132, Wellington land district.

Authentication

Direct PropData requests use an API key supplied in the x-api-key header. Keep direct production keys server-side.

curl "https://propdata-api-worker.sales-fd3.workers.dev/v1/property?country=NZ&parcel=3818618" \ -H "x-api-key: $PROPDATA_API_KEY"

RapidAPI subscriptions use RapidAPI marketplace credentials once the New Zealand listing is promoted. Direct PropData keys and RapidAPI credentials are separate.

Property lookup

GET/v1/property

Resolve a New Zealand property by authoritative address or primary parcel identifier.

ParameterRequiredDescription
countryyesUse NZ.
addressone inputFull NZ address. Use instead of parcel.
parcelone inputLINZ primary parcel ID such as 3818618.

Parcel-level output can include fields such as:

{ "country_code": "NZ", "match_level": "parcel_id", "coverage_status": "live_enriched", "parcel": { "global_parcel_id": "NZ:LINZ_PARCEL:3818618", "parcel_id": "3818618", "appellation": "Lot 1 DP 90132", "land_district": "Wellington", "calc_area": 35805, "survey_area": 35804, "titles": ["1006231", "1007115", "1011310"], "geometry": { "type": "Polygon" }, "bbox": [174.940499917, -41.1891889320649, 174.944342467, -41.1871139320649], "source": "Toitū Te Whenua LINZ" } }
The example documents verified fields from the normalized graph. Exact response size and title truncation are implementation-dependent; read count/truncation metadata when provided rather than assuming an unbounded title array.

Coordinates → property

GET/v1/property/by-location
ParameterRequiredDescription
countryyesNZ
latyesWGS84 latitude.
lngyesWGS84 longitude.
GET /v1/property/by-location?country=NZ&lat=-41.1886269490596&lng=174.943031500008

Coordinate resolution is designed to attach spatial property context without pretending that every point maps to an exact address string.

Property title graph

The title layer is not a scraped ownership blob. PropData maintains national title records and explicit title↔parcel associations from LINZ.

LayerRowsStatus
Property titles2,450,998National baseline complete
Title↔parcel associations2,988,279National baseline complete

Verified title records attached to the Mabey Road parcel include fields such as:

{ "title_no": "1006231", "status": "LIVE", "title_type": "Unit Title", "land_district": "Wellington", "issue_date": "2021-11-01T16:20:02Z", "guarantee_status": "Guarantee", "estate_description": "Stratum in Freehold, 1/1, Unit 44 Deposited Plan 90777", "number_owners": 1, "spatial_extents_shared": true, "source": "Toitū Te Whenua LINZ" }
Title metadata is not the same as named-owner identity. PropData does not infer or fabricate named ownership from title numbers, title types or number_owners.

Parcel geometry

Primary parcel records can carry GeoJSON-compatible polygon geometry, bounding box and area context. Useful parcel fields can include geometry, bbox, centroid, calc_area, survey_area, topology_type, parcel_intent, statutory_actions and affected_surveys where the source supports them.

LINZ building outlines

New Zealand building outlines are a separate national enrichment layer. The current target is 3,268,141 building outlines; the baseline is actively loading and should not yet be interpreted as identical coverage on every property response.

Published source metadata can include:

{ "building_id": 1593810, "building_use": "Unknown", "capture_method": "Feature Extraction", "capture_source_name": "Otago 0.3m Rural Aerial Photos (2019-2021)", "capture_source_group": "NZ Aerial Imagery", "capture_source_from": "2019-02-07", "capture_source_to": "2021-02-24", "territorial_authority": "Clutha District", "source_layer": "NZ Building Outlines", "source": "Toitū Te Whenua LINZ" }
Building-outline ingestion and property-graph linkage are being promoted progressively. Full Enrich remains coverage-aware until national baseline and relationship linkage are complete.

Country capabilities

GET/v1/countries

Returns the country-aware PropData framework and capability context across supported markets. Layer availability remains country-specific.

Health

GET/v1/health

Public production service health.

Platform statistics

GET/v1/stats

Public platform proof points. Do not use global statistics as a substitute for coverage fields on an individual property response.

Changelog

GET/v1/changelog

Production API and data-platform changes.

Match & coverage semantics

PropData is intentionally fail-closed. A property response can distinguish successful identity resolution from downstream layer availability.

SignalPurpose
match_levelHow the input resolved, such as address, parcel or coordinate.
coverage_statusExplicit source/layer coverage state.
parcel_resolutionWhether an address or location attached to parcel identity.
source identifiersPreserve LINZ-native IDs and PropData canonical IDs.
provenanceKeep authoritative-source context visible after normalization.
If a source does not verify a fact, PropData does not manufacture it. Missing geometry, missing title data, no building enrichment and no property match are different states and should be handled differently.

Errors & retries

StatusMeaningRecommended behavior
400Invalid requestCorrect parameters before retrying.
401Authentication failedCheck credentials.
404No matching resourceTreat as a resolution outcome.
429Rate/quota exceededHonor retry and plan limits.
5xxServer/upstream failureRetry with bounded exponential backoff.

Sources & attribution

Core New Zealand property layers are sourced from Toitū Te Whenua Land Information New Zealand (LINZ). PropData maintains the ingestion, normalization, canonical identity, relationship graph, spatial processing, coverage semantics and production delivery above those source systems.

The current LINZ building-outline layer is attributed under its published open-data terms. PropData preserves source attribution and capture provenance in the normalized layer where available.

PropData is an independent product of PropTechUSA.ai and is not operated by or affiliated with LINZ or the New Zealand government.

See the New Zealand pricing and subscription plans for direct API access, or contact sales@proptechusa.ai for bulk, white-label and enterprise delivery.