Results

Retrieve and act on parcel search results.

Endpoints

MethodPathDescription
GET/cadastral/parcels/resultsList all results across tasks
GET/cadastral/parcels/results/:idPaginated results for a single task
POST/cadastral/parcels/results/:id/ingestIngest parcels into supply chain

Result attributes

Each result links an input point to a parcel (or records a failure):

FieldDescription
statuscompleted or failed
input_feature_idHash-based ID of the input point
input_pointOriginal GeoJSON Point geometry
input_propertiesProperties from the original search feature
parcel_idUnique parcel identifier from the cadastral service
country_codeCountry code of the parcel
labelHuman-readable address/label
geoParcel polygon geometry
area_sqmParcel area in square metres
raw_propertiesFull properties from the cadastral service
reasonFailure reason (null for completed results)
tagsTags from the search task

Filtering

Filter results server-side using query parameters:

  • filter[status]=eq:completed โ€” only successful results
  • filter[input_feature_id]=eq:pt-abc123 โ€” results for a specific input point
  • filter[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 country
  • filter[parcel_id]=eq:uuid โ€” find a specific parcel
  • filter[tags]=contains:solar โ€” filter by task tags
  • filter[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:read for viewing, parcels:write for ingesting