2b Search Parcels (Forest Fallback)

Submit a parcel search with "forest_fallback": true. The single point sits outside national cadastral coverage (Amazonas, Brazil), so without the flag it would fail with Unsupported country โ€ฆ. With the flag on, the API resolves a forest polygon for the point and returns it as a completed result.

The task id is captured into {{forest_parcel_task_id}}, so it does not replace the {{parcel_task_id}} that Steps 3โ€“7 address. Inspect the result via GET /cadastral/parcels/results/{{forest_parcel_task_id}} โ€” the forest-fallback row carries label: "Forest segment (AEF)", a forest:{lon},{lat}:{year} parcel_id, an empty country_code, and raw_properties.source.

See the Forest fallback section of Search Parcels for the full contract.

What this step does

It runs the same parcel search as Step 1, but with forest_fallback: true added to the request. For any point that falls outside national cadastral coverage โ€” where the normal lookup would fail with Unsupported country โ€ฆ โ€” the API resolves a forest polygon for that point instead of returning a miss, so the point still yields a usable completed result.

Why it's needed

Cadastral data only exists for supported countries (e.g. US / CA). Sourcing coordinates in regions like the Amazon have no registered parcel to return, so a plain search would leave them as failures with no geometry. Forest fallback fills that gap: it gives those out-of-coverage points a boundary polygon derived from forest data, so they can still flow through review and ingest rather than being dropped.

Why you'd choose this

Turn the flag on when your points span regions without cadastral coverage and you'd rather have an approximate forest-derived boundary than nothing at all. Leave it off (the default) when you only want official registered parcels and would prefer out-of-coverage points to fail explicitly so you can handle them separately. Note it is moot under geometry_source: "segmentation" (Step 2c), which derives geometry a different way.

Next Step

โ†’ Step 2c: Search Parcels Segmentation (variant), or Step 3: Poll Task Status for the main search