Returns budgets the token’s user owns or can edit as a collaborator.
GET
/v1/list_budgetsQuery
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| (none) | — | — | — | No parameters. |
Response data
| Field | Type | Description |
|---|---|---|
| (array) | object[] | Top-level data is an array of budgets (not { items }). |
Item fields
| Field | Type | Description |
|---|---|---|
| id | string | Unique budget id. |
| name | string | Human-readable name shown in the app. |
| baseCurrency | string | ISO 4217 currency code. |
| monthlyNetIncome | number | Monthly net income in base currency. |
| unallocatedAmount | number | Unallocated balance in base currency. |
| refillDay | number | Calendar day (1–31) when unallocated balance refills each month. |
| city | string | Optional city used for cost-of-living context; may be null. |
| ownerId | string | Firebase uid of the budget owner. |