# Budgets

This group of endpoints allows you to retrieve and manage budget data, including listing budgets and fetching individual budget details.

Budgets are organised in a hierarchy where a budget can have multiple members. Each member is associated with a user. Funds can be allocated at the budget level or at the member level, using the flag `has_member_limits`.

![Budget Hierachy](assets/budget-hierarchy.png)


## List budgets

 - [GET /v1/businesses/{client_id}/budgets](https://developer.letsweel.com/openapi/budgets/listbudgets.md)

## Create a budget

 - [POST /v1/businesses/{client_id}/budgets](https://developer.letsweel.com/openapi/budgets/createbudget.md): Creates a budget with the given configuration, initial members, and
owners. All top-level configuration fields are required — no silent
defaults.

## Get budget

 - [GET /v1/businesses/{client_id}/budgets/{budget_id}](https://developer.letsweel.com/openapi/budgets/getbudget.md)

## Update a budget

 - [PATCH /v1/businesses/{client_id}/budgets/{budget_id}](https://developer.letsweel.com/openapi/budgets/updatebudget.md): Updates a budget's top-level configuration. To change members or
owners, use their respective endpoints —
budget members and
budget owners.

## Delete a budget

 - [DELETE /v1/businesses/{client_id}/budgets/{budget_id}](https://developer.letsweel.com/openapi/budgets/deletebudget.md): Deletes a budget. Cascades to members and owners.