---
title: "Delete a budget"
method: DELETE
path: "/v3/spend/budgets/{budgetId}"
tags: ["budgets"]
---

# Delete a budget

`DELETE /v3/spend/budgets/{budgetId}`

Delete an existing budget. A deleted budget cannot be restored. The deleted budget is not available in the list of budgets.

**Note**:
* While you cannot restore a deleted budget with the API, you can unretire budgets in the BILL web app and mobile app. An unretired budget is active and is available for use.
* A one-time budget can be unretired at any time. A `recurringInterval` budget can be unretired within one interval. For example, if a `MONTHLY` budget is retired in January, you can unretire it in February. You cannot unretire this budget in March or any later month.

## Path parameters

- `budgetId` string, required — BILL-generated ID or UUID of the budget

## Headers

- `apiToken` string, nullable — Access token for Spend & Expense API authentication

## Response `200`

Delete a budget response

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)