Skip to content
Zonio Developers

Search

Find parcels with structured filters or a plain-language query.

Search parcels in plain language

POST/search/natural-language

Describe the land you are looking for in English or Polish. Zonio resolves the region, picks the matching scenario and filters, runs the search and returns both the parcels and the structured interpretation, so you can show the user exactly what was searched and re-run it with POST /search/parcels.

Request Body

application/json
queryRequired
string·max 1000
region
string

Optional TERYT code that overrides any place named in the query.

language
string·default en
Values
enpl
limit
integer·max 200·default 20

Responses

Search parcels with structured filters

POST/search/parcels

Hard filters must all pass; survivors are ranked by the optional rank_by signals. Every response carries a coverage array: when a filter's data layer does not cover the region, the filter is reported as missing instead of silently matching nothing.

Request Body

application/json
region
string

TERYT code (2, 4 or 7 digits). Omit to search all of Poland.

bbox
string

WGS84 minLng,minLat,maxLng,maxLat, as an alternative to region.

filters
object

rank_by
object[]

limit
integer·max 200·default 50

Responses