---
title: "Update a single Bill"
method: PATCH
path: "/bills/{id}.json"
tags: ["Bills"]
---

# Update a single Bill

`PATCH /bills/{id}.json`

Outlines the parameters and data fields used when updating a single Bill

## Path parameters

- `id` integer, required

## Query parameters

- `fields` string

## Headers

- `IF-MATCH` string
- `X-API-VERSION` string

## Request body

- object
  - `data` object, required
    - `bill_theme` object
      - `id` integer — The unique identifier of the bill theme applied to the Bill.
    - `currency_id` integer — ID of the currency applied to the Bill.
    - `discount` object
      - `rate` number, double — Discount amount for the Bill. This can either be a percentage or monetary value, this is determined by the `discount[type]`.
      - `type` 'percentage' | 'money' — The type of discount you are applying to your Bill with the `discount[rate]`.
      - `note` string — A note for your Bill's discount.
    - `due_at` string, date — Date the Bill is due. If `use_grace_period` is true, this field is ignored.
    - `interest` object
      - `rate` number, double — Interest amount for the Bill as percentage.
      - `type` 'simple' | 'compound' — The type of interest you are applying to your Bill with the `interest[rate]`.
      - `period` integer — The interest period for how frequently your Bill will charge interest.
    - `issued_at` string, date — Date the Bill was issued.
    - `memo` string — Memo for the Bill.
    - `number` string — Bill's number.
    - `purchase_order` string — Purchase order information for the Bill.
    - `secondary_tax_rate` number, double — Secondary tax rate as percentage for the Bill.
    - `state` 'draft' | 'awaiting_approval' | 'awaiting_payment' | 'paid' | 'void' | 'deleted' — Bill's state.
    - `subject` string — Subject details for the Bill.
    - `tax_rate` number, double — Tax rate as percentage for the Bill
    - `use_grace_period` boolean — When true, sets the bill's due date based on the client's grace period. This setting overrides the `due_at` parameter.

## Response `200`

Ok

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

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