Skip to content
Aireon Developers
Navigation

Site facts (woom digital values) for one parcel

Site values for one Swiss parcel by EGRID (national dd_metric, 20 cantons). Values only, no risk verdicts. null = not available, never zero. Units are in the column names (_m, _deg, _pct, _c, _mm, _ugm3, _cm). Covers shape, terrain (elevation, slope, aspect), road access, population 100 m / 500 m, seismic zone, subsoil, hail, PM10/PM2.5, groundwater heat class, nearby GWR activity, climate normals and 2085 scenarios (RCP 2.6 / 4.5 / 8.5).

Risk flags, scores and classes stay admin-only (/res_api/dd/parcel/{egrid}). sources lists the provenance per column group for the parcel's canton. A parcel outside the covered cantons answers 200 with coverage: "none" and metrics: null.

Auth: a signed-in user's Zitadel id_token, or for server proxies the suite bearer or the suite token header. Cache-Control private, max-age=300; per-IP rate limit 120/min.

GET
https://res.aireon.ch/res_api/dd/metric/{egrid}

Authorization

  • BearerToken
    optional
    HTTP
  • ZitadelJWTVerified
    optional
    HTTP Bearer (JWT)
  • ResApiToken
    optional
    API key in header

Path parameters

  • egrid
    string
    required

    Parcel EGRID, e.g. CH938579012803.

    pattern: ^[Cc][Hh][0-9A-Za-z]{6,24}$

Returns

200

Site values, or coverage: "none" outside the covered cantons.

JSON
  • egrid
    string
    required
  • canton
    string | null
    required

    AV canton code.

  • coverage
    covered
    or
    none
    required
  • metrics
    object | null
    required

    dd_metric column name -> value. Numbers, except aspect_main, seismic_zone, subsoil_class, gw_heat_class and gw_body_type (text). null = not available.

  • sources
    array of
    object
    required
    • group
      optional
      string
    • columns
      optional
      array of
      string
    • source
      optional
      string | null
    • vintage
      optional
      string | null
  • computedAt
    string | null
    required
    format: date-time

400

Invalid EGRID.

401

Authentication missing or invalid.
JSON
  • error
    string
    required

    Human-readable error description.

  • message
    optional
    string

    Optional underlying error message.

404

Unknown EGRID.

429

Rate limited.

Type to search…

↑↓ navigate↵ selectEsc close