---
title: "Revert bill to awaiting invoice"
method: POST
path: "/bills/{id}/revert"
tags: ["Bills"]
---

# Revert bill to awaiting invoice

`POST /bills/{id}/revert`

Revert bill completely back to awaiting invoice state.

## What happens

- Bill record is deleted
- Any payments are deleted
- Entity status reverts to `AWAITING_INVOICE`

## Use case

Use when a bill was recorded incorrectly and needs to start over.

## Path parameters

- `id` string, required

## Query parameters

- `by` 'id' | 'key'

## Request body

- RevertBillRequest
  - `reason` string — Reason for reverting

## Response `200`

Bill reverted successfully

- object
  - `success` boolean
  - `entityStatus` string — New status of the load carrier or vended service

## Other responses

- `401` — Unauthorized - invalid or missing access token
- `404` — Resource not found

---

[API](https://skmtc.net/mvmnt/apis/mvmnt-api.md) · [All operations](https://skmtc.net/mvmnt/apis/mvmnt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mvmnt/mvmnt-api/versions/c44e5e7a4256/schema)