---
title: "Changes to Update Bill record (partial)"
method: PATCH
path: "/public/v1/bills/{record_number}/"
---

# Changes to Update Bill record (partial)

`PATCH /public/v1/bills/{record_number}/`

> Every recorded change to this operation, newest first.
> 35 revisions in range; 1 not diffed.

## Timeline

Changed in 13 of 35 revisions.

- **2026-10-15** `a74a611f93bb`: 5 info
- **2026-10-13** `15055bb59e72`: 1 warning, 1 info
- **2026-10-06** `cd2bd4d748df`: 1 breaking, 1 warning, 6 info
- **2026-10-01** `36038d25069d`: 8 breaking, 8 info
- **2026-09-28** `074797834e54`: 10 info
- **2026-09-26** `c4df6bca164b`: 2 info
- **2026-09-22** `fb10bea0128b`: 20 info
- **2026-09-18** `c7c58bf49281`: 4 info
- **2026-09-03** `b922fa27f8b5`: 3 info
- **2026-08-22** `db5c5da9869c`: 2 breaking, 18 info
- **2026-08-19** `187cbafd893e`: 1 info
- **2026-08-12** `af0ec77e5277`: 1 info
- **2026-08-05** `77cd3c6ec719`: 4 info

## Changes

- **2026-10-15** `a74a611f93bb`: 5 info
  - added the new optional request property `expenses/items/custom_fields`
  - added the new optional request property `items/items/custom_fields`
  - added the optional property `custom_fields/items/field/applies_to/items/layer` to the response with the `200` status
  - added the optional property `expenses/items/custom_fields` to the response with the `200` status
  - added the optional property `items/items/custom_fields` to the response with the `200` status
- **2026-10-13** `15055bb59e72`: 1 warning, 1 info
  - the `memo` request property's maxLength was set to `512`
  - added the new optional request property `auto_calculate_tax`
- **2026-10-06** `cd2bd4d748df`: 1 breaking, 1 warning, 6 info
  - removed the required property `tax_metadata/anyOf[subschema #1: RecordTaxMetadata -> #/components/schemas/RecordTaxMetadata]/avalara` from the response with the `200` status
  - removed the request property `tax_metadata/anyOf[subschema #1: RecordTaxMetadata -> #/components/schemas/RecordTaxMetadata]/avalara`
  - added the optional property `created_by/anyOf[subschema #1: AuditActorSchemaOut]/agent_id` to the response with the `200` status
  - added the optional property `created_by/anyOf[subschema #1: AuditActorSchemaOut]/agent_name` to the response with the `200` status
  - added the optional property `created_by/anyOf[subschema #1: AuditActorSchemaOut]/via` to the response with the `200` status
  - added the optional property `updated_by/anyOf[subschema #1: AuditActorSchemaOut]/agent_id` to the response with the `200` status
  - added the optional property `updated_by/anyOf[subschema #1: AuditActorSchemaOut]/agent_name` to the response with the `200` status
  - added the optional property `updated_by/anyOf[subschema #1: AuditActorSchemaOut]/via` to the response with the `200` status
- **2026-10-01** `36038d25069d`: 8 breaking, 8 info
  - the response property `ship_from_address/anyOf[subschema #1: AddressSchemaOut]/country` became optional for the status `200`
  - the response property `ship_from_address/anyOf[subschema #1: AddressSchemaOut]/second_line` became optional for the status `200`
  - the response property `ship_from_address/anyOf[subschema #1: AddressSchemaOut]/state` became optional for the status `200`
  - the response property `ship_to_address/anyOf[subschema #1: AddressSchemaOut]/country` became optional for the status `200`
  - the response property `ship_to_address/anyOf[subschema #1: AddressSchemaOut]/second_line` became optional for the status `200`
  - the response property `ship_to_address/anyOf[subschema #1: AddressSchemaOut]/state` became optional for the status `200`
  - the `ship_from_address/anyOf[subschema #1: AddressSchemaOut]/country` response's property type changed from `string` to no type for status `200`
  - the `ship_to_address/anyOf[subschema #1: AddressSchemaOut]/country` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/SystemCountries, subschema #1` to the `ship_from_address/anyOf[subschema #1: AddressSchemaOut]/country` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/SystemCountries, subschema #1` to the `ship_to_address/anyOf[subschema #1: AddressSchemaOut]/country` response property `anyOf` list for the response status `200`
  - the `country` response's property default value `` was added for the status `200`
  - the `country` response's property default value `` was added for the status `200`
  - the `second_line` response's property default value `` was added for the status `200`
  - the `second_line` response's property default value `` was added for the status `200`
  - the `state` response's property default value `` was added for the status `200`
  - the `state` response's property default value `` was added for the status `200`
- **2026-09-28** `074797834e54`: 10 info
  - added the optional property `error_code` to the response with the `400` status
  - added the optional property `error_code` to the response with the `404` status
  - added the optional property `error_code` to the response with the `422` status
  - added the optional property `error_code` to the response with the `500` status
  - added the optional property `error_reason` to the response with the `400` status
  - added the optional property `error_reason` to the response with the `404` status
  - added the optional property `error_reason` to the response with the `422` status
  - added the optional property `error_reason` to the response with the `500` status
  - added the optional property `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/valid_to` to the response with the `200` status
  - added the optional property `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/valid_to` to the response with the `200` status
- **2026-09-26** `c4df6bca164b`: 2 info
  - added the optional property `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/rate_description` to the response with the `200` status
  - added the optional property `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/rate_description` to the response with the `200` status
- **2026-09-22** `fb10bea0128b`: 20 info
  - added the new optional request property `expenses/items/billable_customer_id`
  - added the new optional request property `expenses/items/billable_markup_pct`
  - added the new optional request property `expenses/items/billable_project_id`
  - added the new optional request property `expenses/items/is_billable`
  - added the new optional request property `items/items/billable_customer_id`
  - added the new optional request property `items/items/billable_markup_pct`
  - added the new optional request property `items/items/billable_project_id`
  - added the new optional request property `items/items/is_billable`
  - added the optional property `expenses/items/billable_customer_id` to the response with the `200` status
  - added the optional property `expenses/items/billable_customer_name` to the response with the `200` status
  - added the optional property `expenses/items/billable_markup_pct` to the response with the `200` status
  - added the optional property `expenses/items/billable_project_id` to the response with the `200` status
  - added the optional property `expenses/items/billable_project_name` to the response with the `200` status
  - added the optional property `expenses/items/is_billable` to the response with the `200` status
  - added the optional property `items/items/billable_customer_id` to the response with the `200` status
  - added the optional property `items/items/billable_customer_name` to the response with the `200` status
  - added the optional property `items/items/billable_markup_pct` to the response with the `200` status
  - added the optional property `items/items/billable_project_id` to the response with the `200` status
  - added the optional property `items/items/billable_project_name` to the response with the `200` status
  - added the optional property `items/items/is_billable` to the response with the `200` status
- **2026-09-18** `c7c58bf49281`: 4 info
  - added the new optional request property `tax_metadata`
  - added the optional property `ship_from_address` to the response with the `200` status
  - added the optional property `ship_to_address` to the response with the `200` status
  - added the optional property `tax_metadata` to the response with the `200` status
- **2026-09-03** `b922fa27f8b5`: 3 info
  - added the new optional request property `place_of_supply`
  - added the new optional request property `supply_date`
  - added the new optional request property `tax_registration_numbers`
- **2026-08-22** `db5c5da9869c`: 2 breaking, 18 info
  - the `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response's property type changed from `string` to no type for status `200`
  - the `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/GstComponentType, #/components/schemas/TaxFamily` to the `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/GstComponentType, #/components/schemas/TaxFamily` to the `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property `anyOf` list for the response status `200`
  - removed the `CESS` enum value from the `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `CESS` enum value from the `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `CGST` enum value from the `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `CGST` enum value from the `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `GST` enum value from the `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `GST` enum value from the `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `HST` enum value from the `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `HST` enum value from the `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `IGST` enum value from the `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `IGST` enum value from the `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `PST` enum value from the `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `PST` enum value from the `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `QST` enum value from the `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `QST` enum value from the `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `SGST` enum value from the `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
  - removed the `SGST` enum value from the `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_components/items/component_type` response property for the response status `200`
- **2026-08-19** `187cbafd893e`: 1 info
  - added the optional property `code` to the response with the `200` status
- **2026-08-12** `af0ec77e5277`: 1 info
  - added the new optional `header` request parameter `Idempotency-Key`
- **2026-08-05** `77cd3c6ec719`: 4 info
  - added the new optional request property `expenses/items/tax/anyOf[subschema #1: ItemTaxData]/tax_metadata`
  - added the new optional request property `items/items/tax/anyOf[subschema #1: ItemTaxData]/tax_metadata`
  - added the optional property `expenses/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_metadata` to the response with the `200` status
  - added the optional property `items/items/tax/anyOf[subschema #1: ItemTaxDataOut]/tax_metadata` to the response with the `200` status

---

[Operation](https://skmtc.dev/dualentry/apis/dualentry-public-api-2/docs/public/v1/bills/:record_number/patch.md) · [API](https://skmtc.dev/dualentry/apis/dualentry-public-api-2.md) · [Page](https://skmtc.dev/dualentry/apis/dualentry-public-api-2/changes/public/v1/bills/:record_number/patch)