Restituisce il Needed di runway live per ogni box non eliminato (max 30). Con status ready: expectedInAccountToday (apertura) e expectedAfterTodaysBills (chiusura). Altri status senza importi. asOfDate opzionale (yyyy-MM-dd, default oggi UTC) è una riproiezione del piano corrente, non la cronologia Reports — usare get_report per il Needed storico.
GET
/v1/list_box_neededQuery
| Campo | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|
| budgetId | string | Sì | — | Budget da valutare. |
| boxId | string | No | — | Limitare a un box di spese. |
| asOfDate | string | No | today (UTC) | Giorno di calendario yyyy-MM-dd per la proiezione. |
Forma della risposta: { items }. Importi nella valuta del box.
Risposta data
| Campo | Tipo | Descrizione |
|---|---|---|
| items | array | Righe Needed per box. |
Campi elemento
| Campo | Tipo | Descrizione |
|---|---|---|
| boxId | string | Id del box di spese. |
| boxName | string | Nome del box di spese. |
| currency | string | Valuta del box. |
| asOfDate | string | Giorno di proiezione yyyy-MM-dd. |
| status | string | ready, undatedExpenses, missingCreditCycleEndDay o noPlannedExpenses. |
| expectedInAccountToday | number | Needed di apertura se status ready. |
| expectedAfterTodaysBills | number | Needed di chiusura se status ready. |
| hasOutflowsToday | boolean | Vero se ci sono uscite pianificate su asOfDate. |