YNAB - You Need a Budget
Our API uses a REST based design, leverages the JSON data format, and relies upon HTTPS for transport. We respond with meaningful HTTP response codes and if an error occurs, we include error details in the response body. API Documentation is at https://api.youneedabudget.com
YNAB - You Need a Budget endpoints
| Method | Endpoint | Description |
|---|---|---|
| {account id} | ||
| GET |
Accountlist /budgets/{budget_id}/accounts |
Returns all accounts |
| POST |
Createanewaccount /budgets/{budget_id}/accounts |
Creates a new account |
| GET |
Listaccounttransactions /budgets/{budget_id}/accounts/{account_id}/transactions |
Returns all transactions for a specified account |
| GET |
Singleaccount /budgets/{budget_id}/accounts/{account_id} |
Returns a single account |
| {category id} | ||
| GET |
Singlecategory /budgets/{budget_id}/categories/{category_id} |
Returns a single category. Amounts (budgeted, activity, balance, etc.) are specific to the current budget month (UTC). |
| GET |
Listcategorytransactions /budgets/{budget_id}/categories/{category_id}/transactions |
Returns all transactions for a specified category |
| GET |
Listcategories /budgets/{budget_id}/categories |
Returns all categories grouped by category group. Amounts (budgeted, activity, balance, etc.) are specific to the current budget month (UTC). |
| categories/{category id} | ||
| GET |
Listbudgetmonths /budgets/{budget_id}/months |
Returns all budget months |
| GET |
Singlecategoryforaspecificbudgetmonth /budgets/{budget_id}/months/{month}/categories/{category_id} |
Returns a single category for a specific budget month. Amounts (budgeted, activity, balance, etc.) are specific to the current budget month (UTC). |
| PATCH |
Updateacategoryforaspecificmonth /budgets/{budget_id}/months/{month}/categories/{category_id} |
Update a category for a specific month. Only `budgeted` amount can be updated. |
| GET |
Singlebudgetmonth /budgets/{budget_id}/months/{month} |
Returns a single budget month |
| {payee id} | ||
| GET |
Listpayeetransactions /budgets/{budget_id}/payees/{payee_id}/transactions |
Returns all transactions for a specified payee |
| GET |
Singlepayee /budgets/{budget_id}/payees/{payee_id} |
Returns a single payee |
| GET |
Listlocationsforapayee /budgets/{budget_id}/payees/{payee_id}/payee_locations |
Returns all payee locations for a specified payee |
| GET |
Listpayees /budgets/{budget_id}/payees |
Returns all payees |
| payee locations | ||
| GET |
Listpayeelocations /budgets/{budget_id}/payee_locations |
Returns all payee locations |
| GET |
Singlepayeelocation /budgets/{budget_id}/payee_locations/{payee_location_id} |
Returns a single payee location |
| {transaction id} | ||
| POST |
Importtransactions /budgets/{budget_id}/transactions/import |
Imports available transactions on all linked accounts for the given budget. Linked accounts allow transactions to be imported directly from a specified financial institution and… |
| PUT |
Updatesanexistingtransaction /budgets/{budget_id}/transactions/{transaction_id} |
Updates a single transaction |
| POST |
Bulkcreatetransactions /budgets/{budget_id}/transactions/bulk |
Creates multiple transactions. Although this endpoint is still supported, it is recommended to use 'POST /budgets/{budget_id}/transactions' to create multiple transactions. |
| GET |
Singletransaction /budgets/{budget_id}/transactions/{transaction_id} |
Returns a single transaction |
| PATCH |
Updatemultipletransactions /budgets/{budget_id}/transactions |
Updates multiple transactions, by `id` or `import_id`. |
| GET |
Listtransactions /budgets/{budget_id}/transactions |
Returns budget transactions |
| POST |
Createasingletransactionormultipletransactions /budgets/{budget_id}/transactions |
Creates a single transaction or multiple transactions. If you provide a body containing a `transaction` object, a single transaction will be created and if you provide a body… |
| scheduled transactions | ||
| GET |
BudgetSettings /budgets/{budget_id}/settings |
Returns settings for a budget |
| GET |
Userinfo /user |
Returns authenticated user information |
| GET |
Listbudgets /budgets |
Returns budgets list with summary information |
| GET |
Listscheduledtransactions /budgets/{budget_id}/scheduled_transactions |
Returns all scheduled transactions |
| GET |
Singlebudget /budgets/{budget_id} |
Returns a single budget with all related entities. This resource is effectively a full budget export. |
| GET |
Singlescheduledtransaction /budgets/{budget_id}/scheduled_transactions/{scheduled_transaction_id} |
Returns a single scheduled transaction |
YNAB - You Need a Budget pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|