Zwraca bieżące Needed runway dla każdej nieusuniętej skrzynki (max 30). Przy status ready: expectedInAccountToday (otwarcie) i expectedAfterTodaysBills (zamknięcie). Inne statusy bez kwot. Opcjonalne asOfDate (yyyy-MM-dd, domyślnie dziś UTC) to reprojekcja bieżącego planu, nie historia Reports — do stemplowanego Needed użyj get_report.
GET
/v1/list_box_neededZapytanie
| Pole | Typ | Wymagane | Domyślnie | Opis |
|---|---|---|---|---|
| budgetId | string | Tak | — | Budżet do oceny. |
| boxId | string | Nie | — | Ogranicz do jednej skrzynki wydatków. |
| asOfDate | string | Nie | today (UTC) | Dzień kalendarzowy yyyy-MM-dd projekcji. |
Kształt odpowiedzi: { items }. Kwoty w walucie skrzynki.
Odpowiedź data
| Pole | Typ | Opis |
|---|---|---|
| items | array | Wiersze Needed skrzynek. |
Pola elementu
| Pole | Typ | Opis |
|---|---|---|
| boxId | string | Id skrzynki wydatków. |
| boxName | string | Nazwa skrzynki wydatków. |
| currency | string | Waluta skrzynki. |
| asOfDate | string | Dzień projekcji yyyy-MM-dd. |
| status | string | ready, undatedExpenses, missingCreditCycleEndDay lub noPlannedExpenses. |
| expectedInAccountToday | number | Needed otwarcia gdy status ready. |
| expectedAfterTodaysBills | number | Needed zamknięcia gdy status ready. |
| hasOutflowsToday | boolean | True gdy zaplanowane wypływy wypadają na asOfDate. |