Gibt das aktuelle Runway-Needed für jede nicht gelöschte Box zurück (max. 30). Bei status ready: expectedInAccountToday (Opening, inkl. heutiger Rechnungen) und expectedAfterTodaysBills (Closing). Andere Status (undatedExpenses, missingCreditCycleEndDay, noPlannedExpenses) ohne Beträge. Optionales asOfDate (yyyy-MM-dd, Standard UTC heute) ist eine Reprojektion des aktuellen Plans, keine Reports-Historie — für gestempeltes Needed get_report nutzen.
GET
/v1/list_box_neededAbfrage
| Feld | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
| budgetId | string | Ja | — | Zu bewertendes Budget. |
| boxId | string | Nein | — | Auf eine Ausgaben-Box beschränken. |
| asOfDate | string | Nein | today (UTC) | Kalendertag yyyy-MM-dd für die Projektion. |
Antwortform: { items }. Beträge in der Box-Währung.
Antwort-data
| Feld | Typ | Beschreibung |
|---|---|---|
| items | array | Box-Needed-Zeilen. |
Elementfelder
| Feld | Typ | Beschreibung |
|---|---|---|
| boxId | string | ID der Ausgaben-Box. |
| boxName | string | Name der Ausgaben-Box. |
| currency | string | Box-Währung. |
| asOfDate | string | Projektionstag yyyy-MM-dd. |
| status | string | ready, undatedExpenses, missingCreditCycleEndDay oder noPlannedExpenses. |
| expectedInAccountToday | number | Opening-Needed, wenn status ready. |
| expectedAfterTodaysBills | number | Closing-Needed, wenn status ready. |
| hasOutflowsToday | boolean | Wahr, wenn geplante Abflüsse auf asOfDate fallen. |