list_parcels_in_area
List cadastral parcels (land plots) in a chosen area via TERYT, location, bbox, circle, or polygon; optionally return outlines. Find land plots, not transactions or prices.
Instructions
List cadastral parcels in an area - the land plots themselves, NOT transactions (for deeds and prices use search_by_area or search_by_polygon). For an id prefix use search_parcels; for a coordinate or 'locality + number' use resolve_parcel (a street address goes here, via street= and buildingNumber=); for everything about one parcel use get_parcel_report.
Name the area (at least one): teryt (codes from list_locations); location (county, city or gmina NAME; a name shared by several units is an error listing the candidates, never a guess); bbox; lat + lng + radiusKm (a circle; not together with a bbox); polygon (on its own).
Two answer shapes, priced differently: the default LIGHT list (parcel id, district, centre point, held street address; 2 API tokens; cursor paging) and OUTLINES, with includeGeometry=true (needs a bbox) or a polygon (GeoJSON polygon per parcel; 5 API tokens; max 100 parcels, 50 by default; no paging). An outline answer marked TRUNCATED is an arbitrary subset (not the first, nearest or largest): never report it as the area's parcel list, ask for a smaller area.
Light-list filters (not on outline calls) need a narrow scope - a bbox, a circle, a location name, or a teryt of at least 4 digits (county) - and do not count as naming the area. minArea / maxArea (m²) = the registered parcel surface.
street: whole-word, case- and accent-insensitive ('Górna' does not find 'Podgórna'; a fragment finds nothing). Not inflected: pass the NOMINATIVE ('Karmelickiej' answers empty). An empty page is free and carries close-name suggestions - read them before concluding anything.
buildingNumber (needs street): exact ('12A' does not find '12a'); RCN often records compound numbers ('84/92'), so '84' will not find '84/92'. If empty, official address points are tried (still exact); if both miss, the page is empty (free) and lists the numbers held on the street. Most rural parcels have no street: outside towns use resolve_parcel with the precinct name and parcel number; an empty street search in the countryside says nothing about the parcel. parcel_id is returned only to API-token / OAuth callers and paid or trial accounts.
Coverage has two gaps. (1) The cadastral data we hold is near-complete but not live (measured per county; fresh splits, merges or renumbering may be missing), for EVERY entrance: a short list or no truncation marker never means you have every parcel. Each answer has a corpus_coverage block (figures for teryt/location, null for bbox/circle/polygon). (2) bbox, circle and polygon miss the few held parcels whose outline is in an unreadable coordinate system; teryt/location list those with no location. A returned parcel is real; never read an empty or short answer as proof the land is not there. Limits: an area over 500 km², a radius over 12.6 km or a polygon over 500 vertices is refused.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Circle centre latitude (WGS84). Needs lng and radiusKm. | |
| lng | No | Circle centre longitude (WGS84). Needs lat and radiusKm. | |
| bbox | No | Bounding box "minLng,minLat,maxLng,maxLat" (WGS84), at most 500 km². Required for includeGeometry=true. | |
| limit | No | Max parcels. Light list: up to 1000, default 250. Outlines: up to 100, default 50. | |
| teryt | No | TERYT code prefix (2/4/6 digits or finer), comma-separated for several. Wins over location. | |
| cursor | No | Opaque cursor from the previous light-list answer, for the next page; pass it back unchanged. Not available on outline calls. | |
| street | No | Street name in the NOMINATIVE (min 4 letters or digits). Needs a bbox, a circle, a location name, or a teryt of at least 4 digits; not with includeGeometry or a polygon. | |
| maxArea | No | Maximum parcel surface in m². Same scope requirement as minArea. | |
| minArea | No | Minimum parcel surface in m². Needs a narrow scope; not with includeGeometry or a polygon. | |
| polygon | No | GeoJSON Polygon: [longitude, latitude] pairs, first and last point identical, max 500 vertices. Always returns outlines. Pass it instead of the other area parameters. | |
| location | No | County, city, gmina or district name, resolved to its TERYT code ('Mokotów' = that Warszawa district; 'Kraków-Podgórze' = its parent county; a gmina name answers at municipality level). | |
| radiusKm | No | Circle radius in km (max 12.6, the radius covering 500 km²). Needs lat and lng. | |
| buildingNumber | No | Building number, exact; needs street, same scope requirement. If nothing is found, drop the number and read the numbers off the street's rows. | |
| includeGeometry | No | Return full outlines instead of the light row (5 tokens instead of 2). Requires a bbox; with a polygon outlines come back anyway. |