# Nutzungsdauer in der AfA-Tabelle suchen (https://developer.bimetrics.de/reference/assets/search-asset-useful-life)

`GET https://app.bimetrics.de/api/assets/useful-life`

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

Sucht in der amtlichen AfA-Tabelle für allgemein verwendbare Anlagegüter (AfA-Tabelle AV des BMF) mit Wörtern aus dem Alltag, wie die Suche im Block „Anlage“ der App. Liefert höchstens acht Einträge, den besten zuerst, je mit Fundstelle, Nutzungsdauer und der Angabe, ob es Computer-Hardware ist. `entry`, `months` und `computer` gehen als `afaTableEntry`, `usefulLifeMonths` und `computer` in `POST /api/assets/preview`. Passt nichts, braucht eine eigene Nutzungsdauer einen Grund (`usefulLifeReason`). Lesen dürfen alle Rollen.

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 |
| --- | --- | --- | --- | --- |
| `q` | query | nein | string | Alltagswort für die Sache, etwa `Laptop`, `Schreibtisch` oder `Firmenwagen`, höchstens 100 Zeichen. |

### Beispiel

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

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: AssetUsefulLifeList |
| 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 (`AssetUsefulLifeList`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `items` | Array<AssetUsefulLife>, kann null sein | Höchstens acht Einträge, der beste zuerst. |
| `query` | string | Die Suche, ohne Leerzeichen am Rand. |

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