---
title: "Region discovery"
method: POST
path: "/api/v1/tools/region_discovery"
---

# Region discovery

`POST /api/v1/tools/region_discovery`

## Request

- Base URL: `https://verified.realestate`
- URL: `https://verified.realestate/api/v1/tools/region_discovery`
- Auth: HTTP bearer

Find all land parcels inside the region the user drew on the map, matching filters: minimum/maximum area (acres) and exclusions (industrial, eco_sensitive, flood, reserve_forest, aquifer, road_widening, govt). Returns a paginated list of parcels. The selected region polygon is supplied automatically from the map selection, so do NOT ask the user for coordinates and do NOT pass any polygon: when the user has selected a region and asks to list, find or count parcels in an area, just call this tool with the filters. THOSE SEVEN ARE THE ONLY EXCLUSIONS. There is NO agricultural, wet/dry, nanjai/punjai, residential or land-classification filter here, so never promise to "screen out agricultural land" as part of this sweep. When the user asks for that, say plainly that the sweep filters by area and the seven zones above, and offer the real two-step: run the sweep for the size they want, then check land classification per parcel with the registration department's classification lookup (its class grouping is Natham / Wet / Dry) or the zone check with subject cmda_landuse. Costs 4 credits to open a sweep; further pages of the same sweep are free for the first five, then 1 credit per five pages, for 24 hours.

## Request body

- object
  - `min_area_acres` number: Minimum parcel area in acres, if the user asked for one
  - `max_area_acres` number: Maximum parcel area in acres, if the user asked for one
  - `exclude` string[]: Zones to exclude parcels that intersect them
  - `page` integer: Page number for pagination, default 1

## Response `200`

The envelope: ok, status, data, credits_charged, balance_after, request_id

## Other responses

- `401`: No valid credential
- `402`: Not enough credits
- `429`: Rate limit

---

[API](https://skmtc.dev/verified/apis/landlens-tool-api.md) · [All operations](https://skmtc.dev/verified/apis/landlens-tool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verified/apis/landlens-tool-api/revisions/7923c1c24431?raw)