---
title: "One building by EGID"
description: "A single building. With no `month`, returns the latest month the EGID appears in."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.aireon.ch/llms.txt
> Use this file to discover all available pages before exploring further.

Path: RES API (public) › GWR

`GET /res_api/gwr/projects/{egid}`

A single building. With no `month`, returns the latest month the EGID appears in.

## Authentication

Requires one of the following:

- `ResApiToken`, apiKey, in header, header `token`
- `ResApiTokenQuery`, apiKey, in query

## Path parameters

- `egid` (`getGwrProjectByEgid.path.egid`; integer, required)

## Query parameters

- `month` (`getGwrProjectByEgid.query.month`; string, optional): Target month 'YYYY-MM'. Defaults to the latest loaded month.
  - example `"2026-04"`

## Code samples

### cURL

```bash
curl --request GET \
  --url 'https://res.aireon.ch/res_api/gwr/projects/<egid>' \
  --header 'token: <token>'
```

### TypeScript

```typescript
const url = 'https://res.aireon.ch/res_api/gwr/projects/<egid>';
const options = {method: 'GET', headers: {token: '<token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://res.aireon.ch/res_api/gwr/projects/<egid>"

headers = {"token": "<token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

## Responses

### 200

The building.

#### Example

```json
{
  "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
}
```

- `egid` (`getGwrProjectByEgid.response.200.egid`; integer, optional): Federal building identifier.
- `register_match` (`getGwrProjectByEgid.response.200.register_match`; boolean, optional)
- `project_stage` (`getGwrProjectByEgid.response.200.project_stage`; string, optional)
  - one of `"projected"`, `"approved"`, `"under_construction"`, `"existing"`, `"unusable"`, `"not_realized"`, `"demolished"`, `"unknown"`
- `is_pipeline` (`getGwrProjectByEgid.response.200.is_pipeline`; boolean, optional): True for genuine upcoming projects (projected/approved/under construction).
- `status_code` (`getGwrProjectByEgid.response.200.status_code`; integer | null, optional)
- `status_label` (`getGwrProjectByEgid.response.200.status_label`; string | null, optional)
- `category_code` (`getGwrProjectByEgid.response.200.category_code`; integer | null, optional)
- `category_label` (`getGwrProjectByEgid.response.200.category_label`; string | null, optional)
- `class_code` (`getGwrProjectByEgid.response.200.class_code`; integer | null, optional)
- `class_label` (`getGwrProjectByEgid.response.200.class_label`; string | null, optional)
- `municipality_number` (`getGwrProjectByEgid.response.200.municipality_number`; integer | null, optional)
- `municipality_name` (`getGwrProjectByEgid.response.200.municipality_name`; string | null, optional)
- `canton` (`getGwrProjectByEgid.response.200.canton`; string | null, optional)
- `addresses` (`getGwrProjectByEgid.response.200.addresses`; array<string>, optional)
- `entrance_count` (`getGwrProjectByEgid.response.200.entrance_count`; integer | null, optional)
- `year_built` (`getGwrProjectByEgid.response.200.year_built`; integer | null, optional)
- `month_built` (`getGwrProjectByEgid.response.200.month_built`; integer | null, optional)
- `footprint_area_m2` (`getGwrProjectByEgid.response.200.footprint_area_m2`; number | null, optional)
- `volume_m3` (`getGwrProjectByEgid.response.200.volume_m3`; number | null, optional)
- `floors` (`getGwrProjectByEgid.response.200.floors`; integer | null, optional)
- `dwellings` (`getGwrProjectByEgid.response.200.dwellings`; integer | null, optional)
- `egrid` (`getGwrProjectByEgid.response.200.egrid`; string | null, optional)
- `coordinates` (`getGwrProjectByEgid.response.200.coordinates`; object, optional): Building coordinates in LV95 (Swiss) and WGS84.
  - `lv95_e` (`getGwrProjectByEgid.response.200.coordinates.lv95_e`; number | null, optional)
  - `lv95_n` (`getGwrProjectByEgid.response.200.coordinates.lv95_n`; number | null, optional)
  - `lat` (`getGwrProjectByEgid.response.200.coordinates.lat`; number | null, optional)
  - `lng` (`getGwrProjectByEgid.response.200.coordinates.lng`; number | null, optional)
- `likely_minor` (`getGwrProjectByEgid.response.200.likely_minor`; boolean, optional): Heuristic flag for minor entries (carports, sheds, annexes).
- `minor_reason` (`getGwrProjectByEgid.response.200.minor_reason`; string | null, optional)
- `significance_score` (`getGwrProjectByEgid.response.200.significance_score`; integer, optional): Weighted 0-100 score; higher = larger genuine project.

### 400

EGID is not an integer.

### 401

Missing token.

### 403

Wrong token.

### 404

No such building.


Source: https://docs.aireon.ch/res/get-gwr-project-by-egid/index.md