Skip to content
Zonio Developers

REST API overview

The Zonio Geo API is a JSON-over-HTTPS API described by an OpenAPI 3.1 document. Use it when your code knows what it wants: batch scoring, pipelines, dashboards, map backends.

https://api.zonio.tech/v1

Endpoint groups

GroupEndpointsWhat for
SearchPOST /search/natural-language, POST /search/parcelsFind parcels from a sentence or from structured filters
ParcelsGET /parcels/{id}, /at, /autocomplete, /batch, /{id}/regulations, /constraints, /terrain, /proximity, /reportEverything about one parcel or many
GeocodingGET /geocode, GET /regionsAddresses → parcels, names → TERYT codes
MarketGET /market/transactionsNotarised sales and median prices
LayersGET /layers, GET /layers/{id}/featuresThe raw data, by bounding box

Conventions

  • Authentication: Authorization: Bearer <key> on every request. See Authentication.
  • Geometry: GeoJSON in WGS84 (EPSG:4326), RFC 7946, in [lng, lat] order. Responses that are a single feature or a feature collection use application/geo+json.
  • Units: metres, square metres, percent, PLN. Field names carry the unit: area_sqm, distance_m, slope_mean_pct, price_per_sqm_pln.
  • Ids: EGiB parcel ids as published by GUGiK; URL-encode / in path parameters. See Parcels and parcel ids.
  • Regions: TERYT codes as strings ("02", "1261", "1261011"), never integers: leading zeros matter.
  • Pagination: cursor-based. Pass next_cursor back as cursor; null means you're done.
  • Embedding: GET /parcels/{id}?include=regulations,constraints saves round-trips.
  • Nulls are meaningful: regulations.mpzp: null means no plan applies; a missing layer is reported in coverage, never as null.

Versioning

The major version is in the path (/v1). Within a major version we only add: new endpoints, new optional parameters, new response fields and new enum values. Write clients that ignore unknown fields. Breaking changes ship as /v2 with at least 12 months of overlap.

OpenAPI

Download the spec to generate clients or import into Postman, Insomnia or Bruno:

curl -O https://docs.zonio.tech/openapi.yaml