# Anlage AVEÜR lesen (https://developer.bimetrics.de/reference/assets/get-asset-aveuer)

`GET https://app.bimetrics.de/api/assets/aveuer`

operationId: `getAssetAveuer` · Berechtigung (Scope): `read` · Bereich: Anlagen

Liefert die Anlage AVEÜR eines Kalenderjahres aus den gebuchten Werten: je Gruppe (immaterielle Wirtschaftsgüter, Kfz, Büroausstattung, andere) AK-Summe und Buchwert zu Beginn, Zugänge, AfA, Abgänge (Restbuchwerte) und Buchwert am Ende, mit den Kennzahlen des Vordrucks in `codes`. Dazu die AfA beweglicher Wirtschaftsgüter gesamt (490), ob ein Elektro- oder extern aufladbares Hybridfahrzeug vorhanden ist (407), und für die Anlage EÜR AfA (130, 131), GWG (132) und Restbuchwerte (135). GWG stehen nicht in den Gruppen. Die Kennzahlen bleiben, die Zeilen des Vordrucks wandern jedes Jahr.

Benötigt einen Schlüssel mit der Berechtigung `read`.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `year` | query | ja | integer | Kalenderjahr, ab `2025`. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/assets/aveuer" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: AssetAveuer |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diese Route (`APIKeyPermissionDenied`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

#### Felder der Antwort 200 (`AssetAveuer`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `electricVehicle` | boolean | `true`, wenn ein Elektro- oder extern aufladbares Hybridfahrzeug vorhanden ist (Kennzahl 407). |
| `euer` | AssetEuerFigures | Die Werte für die Anlage EÜR. |
| `groups` | Array<AssetAveuerGroup>, kann null sein | Die Gruppen in der Reihenfolge des Vordrucks. |
| `messages` | Array<string> | Hinweise der App. |
| `movableDepreciationCents` | integer | AfA beweglicher Wirtschaftsgüter gesamt (Kennzahl 490) in Cent. |
| `sales` | Array<AssetAveuerSale>, kann null sein | Verkäufe des Jahres und im Jahr bezahlte, für Kennzahl 102. |
| `year` | integer | Kalenderjahr. |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json
