API Bouncer

Buy me a coffee

YNAB

Budgeting & Planning

FinanceAuth: OAuthHTTPS: YesCORS: yesStatus: alive

Last verified: November 12, 2026

Reliability

100% uptime: the documentation responded in 5 of 5 checks over the last 30 days. Median response time: 542 ms.

How we check, and the most reliable APIs →

At a glance

# List budgets (add your API key; see the docs for where it goes) curl "https://api.youneedabudget.com/v1/budgets"

API reference

From YNAB's OpenAPI specification (version 1.0.0), spec updated March 6, 2023, via APIs.guru.

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
  • Base URL: https://api.youneedabudget.com/v1
  • Endpoints: 31
  • Machine-readable spec: OpenAPI JSON (import into Postman, Insomnia or a code generator)
MethodPathWhat it does
GET/budgetsList budgets
GET/budgets/{budget_id}Single budget
GET/budgets/{budget_id}/accountsAccount list
POST/budgets/{budget_id}/accountsCreate a new account
GET/budgets/{budget_id}/accounts/{account_id}Single account
GET/budgets/{budget_id}/accounts/{account_id}/transactionsList account transactions
GET/budgets/{budget_id}/categoriesList categories
GET/budgets/{budget_id}/categories/{category_id}Single category
GET/budgets/{budget_id}/categories/{category_id}/transactionsList category transactions
GET/budgets/{budget_id}/monthsList budget months
GET/budgets/{budget_id}/months/{month}Single budget month
GET/budgets/{budget_id}/months/{month}/categories/{category_id}Single category for a specific budget month
PATCH/budgets/{budget_id}/months/{month}/categories/{category_id}Update a category for a specific month
GET/budgets/{budget_id}/payee_locationsList payee locations
GET/budgets/{budget_id}/payee_locations/{payee_location_id}Single payee location
GET/budgets/{budget_id}/payeesList payees
GET/budgets/{budget_id}/payees/{payee_id}Single payee
GET/budgets/{budget_id}/payees/{payee_id}/payee_locationsList locations for a payee
GET/budgets/{budget_id}/payees/{payee_id}/transactionsList payee transactions
GET/budgets/{budget_id}/scheduled_transactionsList scheduled transactions
GET/budgets/{budget_id}/scheduled_transactions/{scheduled_transaction_id}Single scheduled transaction
GET/budgets/{budget_id}/settingsBudget Settings
GET/budgets/{budget_id}/transactionsList transactions
POST/budgets/{budget_id}/transactionsCreate a single transaction or multiple transactions
PATCH/budgets/{budget_id}/transactionsUpdate multiple transactions

Showing 25 of 31 endpoints. The full list is in the spec above.

History

  • November 12, 2026: last health check, responding

See every change to the directory →