---
title: "Changes to Update a billing entity"
method: PUT
path: "/billing_entities/{code}"
---

# Changes to Update a billing entity

`PUT /billing_entities/{code}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 14 revisions.

- **2026-11-03** `5d26657495a3`: 1 breaking
- **2026-10-16** `fce1879654d8`: 3 breaking, 23 warning, 2 info
- **2026-01-16** `7bf10db291f4`: 4 breaking, 4 warning, 13 info
- **2025-06-09** `083d895c3f8e`: 1 info

## Changes

- **2026-11-03** `5d26657495a3`: 1 breaking
  - the request property `billing_entity/document_number_prefix` became not nullable
- **2026-10-16** `fce1879654d8`: 3 breaking, 23 warning, 2 info
  - added the new required request property `billing_entity`
  - request body became required
  - the response's body type changed from no type to `object` for status `200`
  - removed the request property `address_line1`
  - removed the request property `address_line2`
  - removed the request property `billing_configuration`
  - removed the request property `city`
  - removed the request property `country`
  - removed the request property `default_currency`
  - removed the request property `document_number_prefix`
  - removed the request property `document_numbering`
  - removed the request property `email`
  - removed the request property `email_settings`
  - removed the request property `eu_tax_management`
  - removed the request property `finalize_zero_amount_invoice`
  - removed the request property `invoice_custom_section_codes`
  - removed the request property `legal_name`
  - removed the request property `legal_number`
  - removed the request property `logo`
  - removed the request property `name`
  - removed the request property `net_payment_term`
  - removed the request property `state`
  - removed the request property `tax_codes`
  - removed the request property `tax_identification_number`
  - removed the request property `timezone`
  - removed the request property `zipcode`
  - removed `#/components/schemas/BillingEntityObject, subschema #2` from the response body `allOf` list for the response status `200`
  - added the required property `billing_entity` to the response with the `200` status
- **2026-01-16** `7bf10db291f4`: 4 breaking, 4 warning, 13 info
  - removed the enum value `America/Godthab` of the request property `timezone`
  - removed the enum value `Asia/Rangoon` of the request property `timezone`
  - removed the enum value `Europe/Kiev` of the request property `timezone`
  - the response property `allOf[subschema #2]/taxes/items/description` became nullable for the status `200`
  - added the new `America/Nuuk` enum value to the `allOf[#/components/schemas/BillingEntityObject]/timezone` response property for the response status `200`
  - added the new `Asia/Yangon` enum value to the `allOf[#/components/schemas/BillingEntityObject]/timezone` response property for the response status `200`
  - added the new `Europe/Kyiv` enum value to the `allOf[#/components/schemas/BillingEntityObject]/timezone` response property for the response status `200`
  - added the new `GHS` enum value to the `allOf[#/components/schemas/BillingEntityObject]/default_currency` response property for the response status `200`
  - added the new optional request property `billing_configuration/subscription_invoice_issuing_date_adjustment`
  - added the new optional request property `billing_configuration/subscription_invoice_issuing_date_anchor`
  - added the new optional request property `invoice_custom_section_codes`
  - added the new `America/Nuuk` enum value to the request property `timezone`
  - added the new `Asia/Yangon` enum value to the request property `timezone`
  - added the new `Europe/Kyiv` enum value to the request property `timezone`
  - added the new `GHS` enum value to the request property `default_currency`
  - added the optional property `allOf[#/components/schemas/BillingEntityObject]/subscription_invoice_issuing_date_adjustment` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/BillingEntityObject]/subscription_invoice_issuing_date_anchor` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/selected_invoice_custom_sections` to the response with the `200` status
  - removed the `America/Godthab` enum value from the `allOf[#/components/schemas/BillingEntityObject]/timezone` response property for the response status `200`
  - removed the `Asia/Rangoon` enum value from the `allOf[#/components/schemas/BillingEntityObject]/timezone` response property for the response status `200`
  - removed the `Europe/Kiev` enum value from the `allOf[#/components/schemas/BillingEntityObject]/timezone` response property for the response status `200`
- **2025-06-09** `083d895c3f8e`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/getlago/apis/lago-api-documentation/docs/billing_entities/:code/put.md) - [API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) - [Page](https://skmtc.dev/getlago/apis/lago-api-documentation/changes/billing_entities/:code/put)