Read and manage authoritative parcels and boundaries — tenant-scoped, topology-validated, and versioned — through the Airfree cadastre service.
The Cadastre API manages authoritative parcel and boundary data. It is the system of record for land administration on the platform, enforcing topology validation, tenant scoping, and versioned history on every change.
List and get parcels
Parcels are tenant-scoped: a request only ever sees the parcels its identity is entitled to. Read operations require a valid token; write operations additionally require an appropriate role.
# List parcels in the caller's tenant
curl https://airfree.au/api/v1/cadastre/parcels \
-H "Authorization: Bearer $AIRFREE_TOKEN"
# Get one parcel by id
curl https://airfree.au/api/v1/cadastre/parcels/PARCEL_ID \
-H "Authorization: Bearer $AIRFREE_TOKEN"Register a parcel
Creating a parcel submits geometry and attributes; the service validates topology (no gaps or overlaps against neighbours) before the parcel is committed, and records the change in the parcel’s version history.
curl -X POST https://airfree.au/api/v1/cadastre/parcels \
-H "Authorization: Bearer $AIRFREE_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "reference": "LOT-42-DP-1001", "geometry": { "type": "Polygon", "coordinates": [ ... ] } }'Access control
Cadastre operations are governed by role-based access on top of tenant scoping. A read is available to any entitled user; registration, boundary adjustment, and deletion require the corresponding administrative roles. A token without the role returns 403.