Parcels

Search for cadastral parcel boundaries and manage results.

Endpoints

MethodPathDescription
POST/cadastral/parcels/searchSubmit a parcel search (JSON or file upload)
GET/cadastral/parcels/results/:idRetrieve paginated results with filtering
POST/cadastral/parcels/results/:id/ingestIngest results into your supply chain

Search workflow

  1. Submit point coordinates — each point is routed to the appropriate national cadastral service
  2. The system checks the spatial cache for existing parcel matches
  3. Uncached points are looked up via external APIs (counted against your rate limit)
  4. Results are stored and available for review, filtering, and ingestion

Geometry support

The search accepts any GeoJSON geometry type:

GeometryHandling
PointUsed directly as the lookup coordinate
MultiPointSplit into individual points, each looked up separately
Polygon, LineString, etc.Centroid computed and used as the lookup coordinate

Ingestion

After reviewing search results, you can ingest successful parcels into your supply chain as plots or sheds. This feeds the parcel polygons through the standard ingestion pipeline (normalisation, validation, optional deforestation/emissions metrics).