---
title: "Authentication"
description: "Which endpoints are open, and how to get access to the rest."
---

> 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.

# Authentication

Every operation in the references lists its security. An operation with none is open.

| Access | Covers | How to get it |
| --- | --- | --- |
| Open | revenoo valuation API, RES parcel search, spare space, OEREB document proxy | Nothing to do |
| Aireon account over MCP | Every RES tool in the packs you hold, through [aireon-mcp](/aireon-mcp) | Sign in at [hub.aireon.ch](https://hub.aireon.ch/welcome) and connect |
| aireon-mcp key | The same tools from clients that cannot sign in, plus the PRM listing monitor over REST once you switch PRM access on | Create it on [hub.aireon.ch/mcp](https://hub.aireon.ch/en/mcp) |
| RES token | Direct REST calls to RES parcel, building, score and GWR endpoints | On request from Aireon |

## Data packs

RES operations are grouped in packs, shown as `x-aireon-pack` on each operation. `core` (parcel search and data, zoning statistics, building volumes, POI, routing, GWR records) is free with an Aireon account. `zoning`, `buildings-3d`, `registry`, `market` and `prm` are granted per account; contact Aireon to add one.

## Sending credentials

RES token, in the `token` header:

```sh
curl -s "https://res.aireon.ch/res_api/parcel_data?egrid=CH427058999106" \
  -H "token: <RES_TOKEN>" -H "X-RES-API-Version: 2"
```

aireon-mcp key, as a bearer token (PRM listing monitor only, with PRM access switched on at hub.aireon.ch/mcp):

```sh
curl -s https://res.aireon.ch/res_api/prm_monitor/parcels \
  -H "Authorization: Bearer <AIMCP_KEY>"
```

Treat both like passwords: keep them in a secret store or environment variable, never in a URL you share or in source control. If a key leaks, rotate it on [hub.aireon.ch/mcp](https://hub.aireon.ch/en/mcp); the old one stops working at once.

Source: https://docs.aireon.ch/authentication/index.mdx