Skip to content
LogoLogo

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.

PrefixEnvironmentData
zk_test_sandbox.api.zonio.techKraków and Wrocław only, free, rate-limited
zk_live_api.zonio.techAll 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.

ScopeGrants
parcels:readParcel lookup, regulations, constraints, terrain, proximity
search:readStructured, natural-language and scenario search
market:readTransaction comparables and price medians
layers:readRaw layer queries and vector tiles
reports:createDue-diligence reports (JSON and PDF)

Next: the REST API overview for conventions and errors, or the full API reference.