Reference: Months
A budget month is YNAB’s monthly summary — income, budgeted, activity, and to-be-budgeted, plus
every category’s figures for that month. month accepts an ISO month ("YYYY-MM-01") or the
string "current", which is also the default.
get_month READ
Section titled “get_month READ”Get one budget month (default “current”) with its category breakdown.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
budget_id |
string | Budget id or alias (“last-used”, “default”). Defaults to YNAB_BUDGET_ID. | |
month |
string | “YYYY-MM-01” or “current”. |
YNAB API
- GET
/budgets/{budget_id}/months/{month}→ Months/getPlanMonth
list_months READ
Section titled “list_months READ”List budget months with income/budgeted/activity/to-be-budgeted summaries.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
budget_id |
string | Budget id or alias (“last-used”, “default”). Defaults to YNAB_BUDGET_ID. | |
last_knowledge_of_server |
number |
YNAB API
- GET
/budgets/{budget_id}/months→ Months/getPlanMonths