Quickstart | Aireon Developers

Two open endpoints are enough for a first result: RES parcel search returns the parcel’s EGRID, and revenoo values that EGRID.

Find a parcel

Search by field conditions. This asks for one parcel in Zürich between 1,000 and 1,200 m².

curl -s -X POST https://res.aireon.ch/res_api/parcel_search \
  -H 'content-type: application/json' \
  -d '{"conditions":[{"field":"fso_name_2021","operator":"eq","value":"Zürich"},{"field":"parcel_area","operator":"between","value":1000,"valueTo":1200}],"maxResults":1}'

The answer is a GeoJSON FeatureCollection. The EGRID is properties.parcel_id, for example CH427058999106. Reference: Search parcels.

Value it
```
curl -s https://revenoo.aireon.ch/api/valuation/CH427058999106/summary
```
The summary holds the parcel, market rents of its municipality and the headline values of each method. The first call for an EGRID gathers its data and can take a few seconds; later calls come from cache. Reference: Valuation summary.
Go further
- Change assumptions: POST { "assumptions": { ... } } to the same URL (What-if summary).
- Ask in plain language: connect aireon-mcp to your AI assistant.
- Parcel data, buildings and scores need access: see Authentication.

Conventions

EGRID is the parcel identity everywhere, for example CH427058999106.
Coordinates are WGS84 (EPSG:4326) unless a field says LV95 (EPSG:2056).
Errors: send X-RES-API-Version: 2 to RES to get real HTTP status codes and a JSON { "error": ... } body on the older parcel endpoints.
Rate limit: paths under /api/ on *.aireon.ch allow 30 requests per 10 seconds per IP. Over it you get 429; wait and retry.