Reference: Money movements

Money movements are YNAB’s record of transfers and other budget-to-budget or account-to-account movements, grouped where YNAB groups them. This group is read-only — there’s no tool here that creates or edits a movement, only ones that list what already happened, either across the whole budget or scoped to one month.

Tools

list_money_movement_groups READ

List money movement groups in a budget.

Parameters

Name	Type	Required	Description
budget_id	string		Budget id or alias (“last-used”, “default”). Defaults to YNAB_BUDGET_ID.

YNAB API

• GET /budgets/{budget_id}/money_movement_groups → MoneyMovements/getMoneyMovementGroups

list_money_movements READ

List money movements in a budget.

Parameters

Name	Type	Required	Description
budget_id	string		Budget id or alias (“last-used”, “default”). Defaults to YNAB_BUDGET_ID.

YNAB API

• GET /budgets/{budget_id}/money_movements → MoneyMovements/getMoneyMovements

month_money_movement_groups READ

List money movement groups for a specific budget month.

Parameters

Name	Type	Required	Description
budget_id	string		Budget id or alias (“last-used”, “default”). Defaults to YNAB_BUDGET_ID.
month	string		ISO month or “current”. Defaults to current.

YNAB API

• GET /budgets/{budget_id}/months/{month}/money_movement_groups → MoneyMovements/getMoneyMovementGroupsByMonth

month_money_movements READ

List money movements for a specific budget month.

Parameters

Name	Type	Required	Description
budget_id	string		Budget id or alias (“last-used”, “default”). Defaults to YNAB_BUDGET_ID.
month	string		ISO month or “current”. Defaults to current.

YNAB API

• GET /budgets/{budget_id}/months/{month}/money_movements → MoneyMovements/getMoneyMovementsByMonth