---
title: "Nearby Parcels"
method: GET
path: "/api/v1/cd-spatial/nearby-parcels"
tags: ["Casa Daily — Spatial"]
---

# Nearby Parcels

`GET /api/v1/cd-spatial/nearby-parcels`

## Request

- Base URL: `https://api.casaintelligence.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.casaintelligence.com.au/api/v1/cd-spatial/nearby-parcels`
- Auth: API key in header `X-API-Key`

Cadastral parcels intersecting a bbox of `distance` m around (lat, lng).

Sourced live from the QLD DCDB ArcGIS service. Use this when the
in-DB ST_DWithin RPC returns empty for a property whose neighbours
weren't ingested yet (regional/rural addresses primarily).

Two input modes:
  1. Pass `lat` + `lng` directly (callers that already have them).
  2. Pass `property_id` (UUID) and the endpoint looks up the
     centroid from ci_properties.centroid via ST_Y/ST_X. Saves the
     caller one DB round-trip; this is what casa-daily uses.

On upstream timeout or error returns HTTP 503 — callers should treat
that as "click-to-amalgamate unavailable for this lookup" and render
the rest of the map normally.

## Query parameters

- `lat` number, nullable: Centre latitude (WGS84). Required unless property_id is given.
- `lng` number, nullable: Centre longitude (WGS84). Required unless property_id is given.
- `property_id` string, nullable: ci_properties.id (UUID). When given, the endpoint looks up the property's centroid and uses it as (lat,lng), so callers don't need to do a separate centroid query first.
- `distance` number: Radius in metres; clamped 10-500.

## Response `200`

Successful Response

- NearbyParcelsResponse: GeoJSON FeatureCollection, ready to feed straight into MapLibre.
  - `type` string
  - `features` NearbyParcelFeature[], required
    - `type` string
    - `id` string, nullable
    - `geometry` object, nullable
    - `properties` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/casaintelligence/apis/casa-intelligence-engine.md) · [All operations](https://skmtc.dev/casaintelligence/apis/casa-intelligence-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/casaintelligence/apis/casa-intelligence-engine/revisions/71d711039de0?raw)