List buildings (filtered, paginated)

Filtered, sorted, paginated building list for one month. Each item is the full building object.

GET

https://res.aireon.ch/res_api/gwr/projects

Authorization

ResApiToken
optional
API key in header

ResApiTokenQuery
optional
API key in query

Query parameters

month
optional
string
Target month 'YYYY-MM'. Defaults to the latest loaded month.
canton
optional
string
Two-letter canton code.
stage
optional
string
Project stage.
pipeline
optional
true
or
false
Keep only pipeline (true) or non-pipeline (false).
minor
optional
true
or
false
Keep only likely-minor (true) or exclude them (false).
min_score
optional
integer
Minimum significance score.
q
optional
string
Case-insensitive match on municipality name or address.
bbox
optional
string
Bounding box "minLng,minLat,maxLng,maxLat" (WGS84).
sort
optional
significance_score
or
dwellings
or
floors
or
footprint_area_m2
or
year_built
or
canton
+2 more
Sort column.

default: "significance_score"
order
optional
asc
or
desc
default: "desc"
limit
optional
integer
1-2000, default 200.

default: 200
offset
optional
integer
default: 0

Returns

200

Matching buildings.

JSON

month
optional
string
total
optional
integer
Total matches (before limit/offset).
limit
optional
integer
offset
optional
integer
count
optional
integer
Items in this page.
buildings
optional
array of
object
- egid
  optional
  integer
  Federal building identifier.
- register_match
  optional
  boolean
- project_stage
  optional
  projected
  or
  approved
  or
  under_construction
  or
  existing
  or
  unusable
  or
  not_realized
  +2 more
- is_pipeline
  optional
  boolean
  True for genuine upcoming projects (projected/approved/under construction).
- status_code
  optional
  integer | null
- status_label
  optional
  string | null
- category_code
  optional
  integer | null
- category_label
  optional
  string | null
- class_code
  optional
  integer | null
- class_label
  optional
  string | null
- municipality_number
  optional
  integer | null
- municipality_name
  optional
  string | null
- canton
  optional
  string | null
- addresses
  optional
  array of
  string
- entrance_count
  optional
  integer | null
- year_built
  optional
  integer | null
- month_built
  optional
  integer | null
- footprint_area_m2
  optional
  number | null
- volume_m3
  optional
  number | null
- floors
  optional
  integer | null
- dwellings
  optional
  integer | null
- egrid
  optional
  string | null
- coordinates
  optional
  object
  Building coordinates in LV95 (Swiss) and WGS84.
  
  lv95_e
  optional
  number | null
  lv95_n
  optional
  number | null
  lat
  optional
  number | null
  lng
  optional
  number | null
- likely_minor
  optional
  boolean
  Heuristic flag for minor entries (carports, sheds, annexes).
- minor_reason
  optional
  string | null
- significance_score
  optional
  integer
  Weighted 0-100 score; higher = larger genuine project.
}

401

Missing token.

403

Wrong token.

{ "month": "string", "total": 0, "limit": 0, "offset": 0, "count": 0, "buildings": [ { "egid": 0, "register_match": true, "project_stage": "projected", "is_pipeline": true, "status_code": 0, "status_label": "string", "category_code": 0, "category_label": "string", "class_code": 0, "class_label": "string", "municipality_number": 0, "municipality_name": "string", "canton": "string", "addresses": [ "string" ], "entrance_count": 0, "year_built": 0, "month_built": 0, "footprint_area_m2": 0, "volume_m3": 0, "floors": 0, "dwellings": 0, "egrid": "string", "coordinates": { "lv95_e": 0, "lv95_n": 0, "lat": 0, "lng": 0 }, "likely_minor": true, "minor_reason": "string", "significance_score": 0 } ] }