Get parcel data by coordinate or EGRID

Returns full parcel data for a Swiss parcel, located either by WGS84 coordinate (lat/lng) or by parcel egrid.

With structure: "default" the response is the raw GeoServer GeoJSON FeatureCollection, enriched with owner, isSignal, image_urls and OEREB_url on the first feature's properties. With structure: "tree" the response is a grouped, human-readable object.

GET alias (cacheable). Identical handler and identical response to the POST, with the inputs as query parameters. A POST is uncacheable by browsers and by any CDN, so apps on a first-load path should prefer this GET.

The response carries Cache-Control: private, max-age=3600, stale-while-revalidate=600 and Vary: Origin, token. The policy is private, never public: the endpoint is gated on the token request header, and a header is not part of any shared-cache key - a public/s-maxage directive would let a CDN serve the payload to a caller that never presented the token. Error responses (including the legacy HTTP-200 plain-text ones) carry Cache-Control: no-store.

GET

https://res.aireon.ch/res_api/parcel_data

Authorization

ResApiToken
API key in header
required

Query parameters

egrid
optional
string
Canonical federal parcel id (EGRID). Preferred over lat/lng.
lat
optional
number
WGS84 latitude. Required together with lng when egrid is absent.
lng
optional
number
WGS84 longitude. Required together with lat when egrid is absent.
structure
optional
string
default (raw enriched FeatureCollection) or tree (grouped shape).

Returns

200

Parcel data. Shape depends on the structure field. Note: a missing/invalid token or missing location produces a plain-text 200 body (see description).

JSON

One of the following:

GeoJSONFeatureCollection
- type
  optional
  string
- features
  optional
  array of
  object
  type
  optional
  string
  id
  optional
  string
  geometry
  optional
  object
  properties
  optional
  object
  Open property bag. /res_api/parcel_data adds the following room-app density fields on the first feature.
  
  ratio_v
  optional
  number | null
  Built volume relative to the zone reference volume (percent; 100 = typical for the zone), i.e. cz_util_now divided by the zone 20-year median utilization x 100. It is not utilization and not a share of a legal allowance. Existing value from the parcel table is passed through unchanged; computed as bldg_vol_sb3dgdb / vol_max * 100 when absent (vol_max is the zone reference volume).
  
  free_v
  optional
  number | null
  vol_max - bldg_vol_sb3dgdb, in m³: the zone reference volume minus the built volume. Negative when the parcel is built above the zone reference; not a legal allowance.
  
  ratio_s
  optional
  number | null
  Built-footprint / parcel_area (percent). Passed through from the parcel table when populated.
  
  gfz
  optional
  number | null
  Geschossflächenziffer - gfa_now / parcel_area.
  
  bldg_height_m
  optional
  number | null
  Tallest building on the parcel, in metres (= bldg_height_max).
  
  bldg_floors_n
  optional
  number | null
  Max number of floors on the parcel (= bldg_floors).
}
ParcelTree
- name
  optional
  string
- description
  optional
  string
- owner
  optional
  array of
  object
- site_score
  optional
  number | null
- res_id
  optional
  string | number | null
- uuid
  optional
  string
  UUIDv5 derived from the parcel EGRID.
- score
  optional
  object
  score_drive
  optional
  number | null
  score_walk
  optional
  number | null
  score_bike
  optional
  number | null
- address
  optional
  object
  street
  optional
  string | null
  city
  optional
  string | null
  canton
  optional
  string | null
  zip
  optional
  string | number | null
  parcel_id
  optional
  string
  coordinates
  optional
  object
  x
  optional
  number
  Web Mercator (EPSG:3857) X.
  
  y
  optional
  number
  Web Mercator (EPSG:3857) Y.
  
  x_2056
  optional
  number
  LV95 (EPSG:2056) X.
  
  y_2056
  optional
  number
  LV95 (EPSG:2056) Y.
  
  lat
  optional
  number
  WGS84 latitude.
  
  lng
  optional
  number
  WGS84 longitude.
- building
  optional
  object
  Building attributes (construction year, flats, floors, size, volume, heights).
- plot
  optional
  object
  Plot attributes (area, ratios, GFA, max footprint/volume).
- construction_zone
  optional
  object
  Construction-zone attributes.
- noise
  optional
  object
  Rail and street noise levels (day/night, min/mean/max).
- travel
  optional
  object
  Travel times to the nearest agglomeration.
- vacancies
  optional
  object
  District vacancy figures.
- tax
  optional
  object
  Tax attributes.
- image_urls
  optional
  object
  parcel_image
  optional
  string
  format: uri
  satellite_image
  optional
  string
  format: uri
  world_topo_image
  optional
  string
  format: uri
- OEREB_url
  optional
  string
  OEREB extract URL, or not available.
}

HTML

Missing Token

401

Authentication missing or invalid.

JSON

error
string
required
Human-readable error description.
message
optional
string
Optional underlying error message.