Results
Retrieve and act on parcel search results.
โถEndpoints
| Method | Path | Description |
|---|---|---|
| GET | /cadastral/parcels/results | List all results across tasks |
| GET | /cadastral/parcels/results/:id | Paginated results for a single task |
| POST | /cadastral/parcels/results/:id/ingest | Ingest parcels into supply chain |
โถResult attributes
Each result links an input point to a parcel (or records a failure):
| Field | Description |
|---|---|
status | completed or failed |
input_feature_id | Hash-based ID of the input point |
input_point | Original GeoJSON Point geometry |
input_properties | Properties from the original search feature |
parcel_id | Unique parcel identifier from the cadastral service |
country_code | Country code of the parcel |
label | Human-readable address/label |
geo | Parcel polygon geometry |
area_sqm | Parcel area in square metres |
raw_properties | Full properties from the cadastral service |
reason | Failure reason (null for completed results) |
tags | Tags from the search task |
โถFiltering
Filter results server-side using query parameters:
filter[status]=eq:completedโ only successful resultsfilter[input_feature_id]=eq:pt-abc123โ results for a specific input pointfilter[input_properties.ref]=eq:S-001โ filter by original input properties (JSONB dot-notation)filter[raw_properties.owner]=eq:Smithโ filter by raw parcel properties (JSONB dot-notation)filter[country_code]=eq:USโ filter by countryfilter[parcel_id]=eq:uuidโ find a specific parcelfilter[tags]=contains:solarโ filter by task tagsfilter[task_id]=eq:uuidโ scope to a specific task (list-all endpoint only)
โถResponse formats
Accept: application/jsonโ paginated JSON envelope (default)Accept: application/geo+jsonโ GeoJSON FeatureCollection with parcel polygons
โถIngestion
Promote successful parcel results into your supply chain via POST /cadastral/parcels/results/:id/ingest. This creates plot or shed records through the standard ingestion pipeline, including normalisation, validation, and optional deforestation/emissions metrics.
Duplicate parcels (same parcel matched by multiple input points) are automatically deduplicated before ingestion.
Required scope:
parcels:readfor viewing,parcels:writefor ingesting