Get Results
Retrieve paginated parcel search results for a completed task. Includes both successful and failed parcels with their original input points and parcel polygon geometries.
โถUse Cases
- Retrieve parcel polygons after a search completes.
- Export results as GeoJSON for use in GIS tools or dashboards.
- Filter results by status, country, or parcel attributes.
โถFailed results
When a point couldn't be matched, the result row has status: "failed" and a human-readable explanation in the reason field. Common reasons include unsupported regions, rate-limit denials, and provider errors. For rate-limit reasons specifically (e.g. "Rate limit exceeded โ retry after Ns"), see the Rate limiting section in Search Parcels for how to monitor your quota and time retries.
Filter to failures only with filter[status]=eq:failed to triage what needs resubmitting.
โถMatch distance (matched_distance_m)
matched_distance_m)Each successful row carries matched_distance_m โ metres from the query point to the returned polygon. It is 0 when the point is inside the polygon (a containing parcel, or a forest segment), and > 0 when no parcel contained the point and the nearest parcel within match_radius_m was returned instead (see Search Parcels โ Nearest parcel). It is null on failed rows. Use it to tell an exact cadastral hit from a nearby match.
โถForest-fallback results
If the search was submitted with "forest_fallback": true (see Search Parcels), points that had no cadastral parcel are resolved to a forest polygon instead of failing. These come back as ordinary completed parcel_result rows, distinguishable by:
labelis"Forest segment (AEF)"parcel_idisforest:{lon},{lat}:{year}(not a provider parcel id)country_codeis""(empty)area_sqmisnullraw_properties.source(e.g."aef-watershed") andraw_properties.source_yearare set
A diverted point that still has no forest segment is a failed row with reason "no forest polygon for point".
To isolate forest-fallback results, filter on the source: filter[raw_properties.source]=eq:aef-watershed.
โถFilters
Use filter[field]=condition:value to narrow results. See Query Parameters for full syntax.
filter[status]=eq:completedโ only successful resultsfilter[country_code]=eq:USโ filter by countryfilter[parcel_id]=eq:<uuid>โ find a specific parcelfilter[tags]=contains:solarโ filter by task tagsfilter[raw_properties.owner]=eq:Smithโ filter by raw parcel propertiesfilter[input_properties.ref]=eq:S-001โ filter by input properties
Required scope:
parcels:read