# You Need A Budget YNAB API Endpoints API

> You Need A Budget YNAB API Endpoints API on Apizie: 31 endpoints (User info, List budgets, Single budget, Budget Settings, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/finance:youneedabudget/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `finance:youneedabudget`
- Category: Finance
- Status: byok
- Source: https://api.youneedabudget.com
- Page: https://apizie.tech/api/finance/youneedabudget
- OpenAPI: https://apizie.tech/api/finance/youneedabudget/openapi.json

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…

## Endpoints

### User info
`GET https://apizie.tech/v1/finance:youneedabudget/user-info-get` (byok)

### List budgets
`GET https://apizie.tech/v1/finance:youneedabudget/budgets-list-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| include_accounts | boolean | no | Whether to include the list of budget accounts |

### Single budget
`GET https://apizie.tech/v1/finance:youneedabudget/budgets-get-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| last_knowledge_of_server | integer | no | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. |

### Budget Settings
`GET https://apizie.tech/v1/finance:youneedabudget/budgets-get-settings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |

### Account list
`GET https://apizie.tech/v1/finance:youneedabudget/accounts-list-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| last_knowledge_of_server | integer | no | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. |

### Create a new account
`POST https://apizie.tech/v1/finance:youneedabudget/accounts-create-new-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget ("last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| body | object | yes | JSON request body |

### Single account
`GET https://apizie.tech/v1/finance:youneedabudget/accounts-get-single-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| account_id | string | yes | The id of the account |

### List categories
`GET https://apizie.tech/v1/finance:youneedabudget/categories-list-by-budget-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| last_knowledge_of_server | integer | no | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. |

### Single category
`GET https://apizie.tech/v1/finance:youneedabudget/categories-get-single-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| category_id | string | yes | The id of the category |

### Update a category
`POST https://apizie.tech/v1/finance:youneedabudget/categories-update-category-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| category_id | string | yes | The id of the category |
| body | object | yes | JSON request body |

### Single category for a specific budget month
`GET https://apizie.tech/v1/finance:youneedabudget/categories-get-month-category-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| month | string | yes | The budget month in ISO format (e.g. 2016-12-01) ("current" can also be used to specify the current calendar month (UTC)) |
| category_id | string | yes | The id of the category |

### Update a category for a specific month
`POST https://apizie.tech/v1/finance:youneedabudget/categories-update-month-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| month | string | yes | The budget month in ISO format (e.g. 2016-12-01) ("current" can also be used to specify the current calendar month (UTC)) |
| category_id | string | yes | The id of the category |
| body | object | yes | JSON request body |

### List payees
`GET https://apizie.tech/v1/finance:youneedabudget/payees-list-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| last_knowledge_of_server | integer | no | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. |

### Single payee
`GET https://apizie.tech/v1/finance:youneedabudget/payees-get-single-payee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| payee_id | string | yes | The id of the payee |

### List payee locations
`GET https://apizie.tech/v1/finance:youneedabudget/payee-locations-list-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |

### Single payee location
`GET https://apizie.tech/v1/finance:youneedabudget/payee-locations-get-single` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| payee_location_id | string | yes | id of payee location |

### List locations for a payee
`GET https://apizie.tech/v1/finance:youneedabudget/payee-locations-list-by-payee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| payee_id | string | yes | id of payee |

### List budget months
`GET https://apizie.tech/v1/finance:youneedabudget/months-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| last_knowledge_of_server | integer | no | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. |

### Single budget month
`GET https://apizie.tech/v1/finance:youneedabudget/months-get-single` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| month | string | yes | The budget month in ISO format (e.g. 2016-12-01) ("current" can also be used to specify the current calendar month (UTC)) |

### List transactions
`GET https://apizie.tech/v1/finance:youneedabudget/transactions-list-transactions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| since_date | string | no | If specified, only transactions on or after this date will be included. The date should be ISO formatted (e.g. 2016-12-30). |
| type | string | no | If specified, only transactions of the specified type will be included. "uncategorized" and "unapproved" are currently supported. |
| last_knowledge_of_server | integer | no | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. |

### Create a single transaction or multiple transactions
`POST https://apizie.tech/v1/finance:youneedabudget/transactions-create-single-or-multiple` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| body | object | yes | JSON request body |

### Update multiple transactions
`POST https://apizie.tech/v1/finance:youneedabudget/transactions-update-multiple` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| body | object | yes | JSON request body |

### Import transactions
`POST https://apizie.tech/v1/finance:youneedabudget/transactions-import-linked-accounts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |

### Single transaction
`GET https://apizie.tech/v1/finance:youneedabudget/transactions-get-single-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| transaction_id | string | yes | The id of the transaction |

### Updates an existing transaction
`POST https://apizie.tech/v1/finance:youneedabudget/transactions-update-existing-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| transaction_id | string | yes | The id of the transaction |
| body | object | yes | JSON request body |

### Deletes an existing transaction
`POST https://apizie.tech/v1/finance:youneedabudget/transactions-delete-existing-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| transaction_id | string | yes | The id of the transaction |

### List account transactions
`GET https://apizie.tech/v1/finance:youneedabudget/transactions-list-by-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| account_id | string | yes | The id of the account |
| since_date | string | no | If specified, only transactions on or after this date will be included. The date should be ISO formatted (e.g. 2016-12-30). |
| type | string | no | If specified, only transactions of the specified type will be included. "uncategorized" and "unapproved" are currently supported. |
| last_knowledge_of_server | integer | no | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. |

### List category transactions, excluding any pending transactions
`GET https://apizie.tech/v1/finance:youneedabudget/transactions-list-by-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| category_id | string | yes | The id of the category |
| since_date | string | no | If specified, only transactions on or after this date will be included. The date should be ISO formatted (e.g. 2016-12-30). |
| type | string | no | If specified, only transactions of the specified type will be included. "uncategorized" and "unapproved" are currently supported. |
| last_knowledge_of_server | integer | no | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. |

### List payee transactions, excluding any pending transactions
`GET https://apizie.tech/v1/finance:youneedabudget/transactions-list-by-payee` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| payee_id | string | yes | The id of the payee |
| since_date | string | no | If specified, only transactions on or after this date will be included. The date should be ISO formatted (e.g. 2016-12-30). |
| type | string | no | If specified, only transactions of the specified type will be included. "uncategorized" and "unapproved" are currently supported. |
| last_knowledge_of_server | integer | no | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. |

### List scheduled transactions
`GET https://apizie.tech/v1/finance:youneedabudget/scheduled-transactions-list-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| last_knowledge_of_server | integer | no | The starting server knowledge. If provided, only entities that have changed since `last_knowledge_of_server` will be included. |

### Single scheduled transaction
`GET https://apizie.tech/v1/finance:youneedabudget/scheduled-transactions-get-single-scheduled-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| budget_id | string | yes | The id of the budget. "last-used" can be used to specify the last used budget and "default" can be used if default budget selection is… |
| scheduled_transaction_id | string | yes | The id of the scheduled transaction |

## Example
```
curl "https://apizie.tech/v1/finance:youneedabudget/user-info-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the You Need A Budget YNAB API Endpoints API?
Create a free Apizie key, then send GET https://apizie.tech/v1/finance:youneedabudget/user-info-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the You Need A Budget YNAB API Endpoints API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. You Need A Budget YNAB API Endpoints itself also needs your own key from api.ynab.com.

### Can AI agents use the You Need A Budget YNAB API Endpoints API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key finance:youneedabudget.

### What is the status of the You Need A Budget YNAB API Endpoints API?
Needs your own provider key (bring your own key)