# 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)

 - [GET /v1/businesses/{client_id}/budgets](https://developer.letsweel.com/openapi/budgets/listbudgets.md)
 - [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 /v1/businesses/{client_id}/budgets/{budget_id}](https://developer.letsweel.com/openapi/budgets/getbudget.md)
 - [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](#tag/Budget-Members) and [budget owners](#tag/Budget-Owners).
 - [DELETE /v1/businesses/{client_id}/budgets/{budget_id}](https://developer.letsweel.com/openapi/budgets/deletebudget.md): Deletes a budget. Cascades to members and owners.