# „Zu erledigen“ lesen (https://developer.bimetrics.de/reference/tasks/get-tasks)

`GET https://app.bimetrics.de/api/home/tasks`

operationId: `getTasks` · Berechtigung (Scope): `read` · Bereich: Zu erledigen

Liefert dieselben Aufgaben wie die Startseite: Belege prüfen, Zahlungen ohne Beleg, überfällige Rechnungen, nicht zugestellte Mails, ablaufende Bankfreigaben und Mails im Postfach, je Art eine Zeile mit Anzahl, dazu den Monatsstand der Belege und Zahlungen. Die Zahlen sind dieselben wie in den Listen der App. Ohne `month` kommen der Vormonat und der laufende Monat; die Zeilen nennen bis zum 10. die Arbeit des Vormonats, solange dort etwas offen ist, sonst die des laufenden.

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 |
| --- | --- | --- | --- | --- |
| `month` | query | nein | string | Optional ein Monat `YYYY-MM`, nicht in der Zukunft: Monatsstand und Zeilen nur dieses Monats. |

### Beispiel

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

### Antworten

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

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `asOf` | string | Heutiges Datum in Deutschland, YYYY-MM-DD. |
| `bankApprovals` | Array<TaskBankApproval>, kann null sein | Bankfreigaben, die in den nächsten sieben Tagen ablaufen, die früheste zuerst. Erneuern geht nur in der App unter Einstellungen › Bank. |
| `months` | Array<TaskMonthStatus>, kann null sein | Monatsstand: der Vormonat, dann der laufende Monat; mit `month` nur dieser. |
| `rows` | Array<TaskRow>, kann null sein | Eine Zeile je Art mit offener Arbeit, in der Reihenfolge der Startseite. Fehlt eine Art, ist dort nichts zu tun. |

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