---
title: "Quick Start"
description: "Ihr erster API-Call mit /housingstock/flats"
url: "https://portal.api.aareon.com/guides/quickstart"
image: "https://portal.api.aareon.com/_og/d/c_Ocean.takumi,title_Quick+Start,description_~SWhyIGVyc3RlciBBUEktQ2FsbCBtaXQgL2hvdXNpbmdzdG9jay9mbGF0cw,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMwNTExNjMifX19,p_Ii9ndWlkZXMvcXVpY2tzdGFydCI,s_Q_sVI7E1PlQxjoKT.png"
---

# Quick Start: Erster API-Call

Willkommen im API Portal! In diesem Quick Start zeigen wir Ihnen, wie Sie Ihren ersten API-Aufruf mit dem Endpunkt **`/housingstock/flats`** durchführen. Weitere Endpunkte finden Sie, nach der Freischaltung, unter: ➡️ [APIs](https://portal.api.aareon.com/apis)

## [1\. Access Token abrufen](#_1-access-token-abrufen)

Bevor Sie unsere APIs nutzen können, benötigen Sie ein gültiges **Access Token**. Bitte folgen Sie dazu der Anleitung unter: ➡️ [Authentifizierung (Client Credentials Flow)](https://portal.api.aareon.com/guides/authentication)

---

## [2\. Erster API-Aufruf: `/housingstock/flats`](#_2-erster-api-aufruf-housingstockflats)

Sobald Sie Ihr Access Token haben, können Sie direkt den ersten API-Call ausführen. Verwenden Sie dazu den **Authorization Header** und geben Sie zusätzlich den Header `x-customer: yuneo` mit, um zu identifizieren zu welchem ERP System Sie sich verbinden.

> **Hinweis**: Aktuell gibt es die Direkt Connect Anbindung ausschließlich für Wodis Yuneo

### [Beispiel (cURL)](#beispiel-curl)

```Beispiel
curl -X GET "https://api.aareon.com/housingstock/flats" \
  -H "Authorization: Bearer <access_token>" \
  -H "x-customer: yuneo"
```

Beispiel (Python)

```python
import requests

api_url = "https://api.aareon.com/housingstock/flats"
access_token = "<access_token>"  # hier das Token aus Schritt 1 einsetzen

headers = {
    "Authorization": "Bearer {access_token}",
    "x-customer": "yuneo"
}

response = requests.get(api_url, headers=headers)
print(response.json())
```

## [3\. Ergebnis](#_3-ergebnis)

Die Antwort liefert eine Liste der verfügbaren Wohnungseinheiten (flats).

✅ Damit haben Sie erfolgreich Ihren ersten Call an die API durchgeführt! Sie können nun weitere Endpunkte erkunden und die Daten in Ihre Anwendung integrieren.