Quickstart
This page covers the REST API. AI agents connect to the MCP server with a Zonio account instead of an API key: see Connect your agent.
Get an API key
The REST API is in private preview: email kontakt@zonio.tech for access. Once approved, open Settings → API keys in the Zonio app and create a key. A key belongs to an organization, not a person, so it survives team changes.
export ZONIO_API_KEY="zk_test_4f9c2b..."Find a parcel
Look up the parcel under a point, here Kraków's main market square:
curl "https://api.zonio.tech/v1/parcels/at?lng=19.9372&lat=50.0614" \
-H "x-api-key: $ZONIO_API_KEY"{
"type": "Feature",
"id": "126101_1.0001.27/2",
"geometry": { "type": "Polygon", "coordinates": [[[19.9365, 50.0611], "…"]] },
"properties": {
"parcel_id": "126101_1.0001.27/2",
"area_sqm": 31260.4,
"gmina": "Kraków",
"teryt": "1261011"
}
}Ask what can be built there
curl "https://api.zonio.tech/v1/parcels/126101_1.0001.27%2F2/regulations" \
-H "x-api-key: $ZONIO_API_KEY"You get the local plan zone, the general plan zone and any pre-emption rights. Every parcel endpoint is in the API reference.
Search in plain language
curl https://api.zonio.tech/v1/search/natural-language \
-H "x-api-key: $ZONIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "vacant plots over 1 ha zoned for housing in Wieliczka, within 800 m of a bus stop"}'The response contains the matching parcels and the structured filters Zonio derived from your sentence. See Search for the structured variant.
Authentication
Every REST API request carries an x-api-key header. There are no anonymous endpoints.
| Prefix | Environment | Data |
|---|---|---|
zk_test_ | sandbox.api.zonio.tech | Kraków and Wrocław only, free, rate-limited |
zk_live_ | api.zonio.tech | All of Poland, billed per plan |
Scopes
Restrict a key to what it needs. A key handed to an AI agent should usually be read-only.
| Scope | Grants |
|---|---|
parcels:read | Parcel lookup, regulations, constraints, terrain, proximity |
search:read | Structured, natural-language and scenario search |
market:read | Transaction comparables and price medians |
layers:read | Raw layer queries and vector tiles |
reports:create | Due-diligence reports (JSON and PDF) |
Next: the REST API overview for conventions and errors, or the full API reference.