Close menu
Explore Plans
Mobile menu Close menu
YNAB (You Need A Budget)

List categories

Pro plus icon Returns a list of categories for a YNAB plan.

Developer info

API endpoint slug
you_need_a_budget.list_categories
Runtime method
performQuery("you_need_a_budget.list_categories"}

Query fields

Budget Dropdown list

Label
Plan
Helper text
Choose a plan.
Slug
budget_id
Required
true
Can have default value
false

Ingredients

Category name The name of the category.

Slug
category_name
Filter code
YouNeedABudget.listCategories.CategoryName
Type
String
Example
Groceries

Category group name The name of the category group.

Slug
category_group_name
Filter code
YouNeedABudget.listCategories.CategoryGroupName
Type
String
Example
Everyday Expenses

Budgeted The amount budgeted for this category.

Slug
budgeted
Filter code
YouNeedABudget.listCategories.Budgeted
Type
String
Example
400.00

Available The remaining amount available in this category.

Slug
balance
Filter code
YouNeedABudget.listCategories.Available
Type
String
Example
150.00

Category The unique identifier of the category.

Slug
category_id
Filter code
YouNeedABudget.listCategories.CategoryId
Type
String
Example
a1b2c3d4-e5f6-7890-abcd-ef1234567890