---
title: "Changes to Finalizes an invoice"
method: PATCH
path: "/api/v2/invoices/{id}/finalize"
---

# Changes to Finalizes an invoice

`PATCH /api/v2/invoices/{id}/finalize`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 49 revisions.

- **2026-11-02** `fa3060fd0144`: 8 info
- **2026-10-27** `f11a8740641a`: 30 breaking, 2 warning, 98 info

## Changes

- **2026-11-02** `fa3060fd0144`: 8 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `406`
  - added the non-success response with the status `408`
  - added the non-success response with the status `423`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
- **2026-10-27** `f11a8740641a`: 30 breaking, 2 warning, 98 info
  - the response property `data/attributes/pay_on` became nullable for the status `200`
  - the response property `data/attributes/payment_terms` became nullable for the status `200`
  - the `data/attributes/bank_account_details` response's property type changed from `object` to no type for status `200`
  - the `data/attributes/company_reference_id` response's property type changed from `integer` to no type for status `200`
  - the `data/attributes/creation_options` response's property type changed from `object` to no type for status `200`
  - the `data/attributes/custom_fields` response's property type changed from `object` to no type for status `200`
  - the `data/attributes/deleted_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200`
  - the `data/attributes/delivery_on` response's property type changed from `string` to no type, and format from `date` to no format for status `200`
  - the `data/attributes/discount` response's property type changed from `number` to no type for status `200`
  - the `data/attributes/exchange_rate` response's property type changed from `number` to no type for status `200`
  - the `data/attributes/export_id` response's property type changed from `string` to no type for status `200`
  - the `data/attributes/export_integration_type_id` response's property type changed from `integer` to no type for status `200`
  - the `data/attributes/export_invoice_url` response's property type changed from `string` to no type for status `200`
  - the `data/attributes/exported_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200`
  - the `data/attributes/finalized_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200`
  - the `data/attributes/finalized_on` response's property type changed from `string` to no type, and format from `date` to no format for status `200`
  - the `data/attributes/invoice_template_id` response's property type changed from `integer` to no type for status `200`
  - the `data/attributes/note` response's property type changed from `string` to no type for status `200`
  - the `data/attributes/number` response's property type changed from `string` to no type for status `200`
  - the `data/attributes/paid_on` response's property type changed from `string` to no type, and format from `date` to no format for status `200`
  - the `data/attributes/payment_terms_days` response's property type changed from `integer` to no type for status `200`
  - the `data/attributes/payment_terms_type` response's property type changed from `string` to no type for status `200`
  - the `data/attributes/purchase_order_number` response's property type changed from `string` to no type for status `200`
  - the `data/attributes/sent_on` response's property type changed from `string` to no type, and format from `date` to no format for status `200`
  - the `data/attributes/subject` response's property type changed from `string` to no type for status `200`
  - the `data/attributes/tag_list` response's property type changed from `string` to no type for status `200`
  - the `data/attributes/tax1_name` response's property type changed from `string` to no type for status `200`
  - the `data/attributes/tax1_value` response's property type changed from `number` to no type for status `200`
  - the `data/attributes/tax2_name` response's property type changed from `string` to no type for status `200`
  - the `data/attributes/tax2_value` response's property type changed from `number` to no type for status `200`
  - deleted the `header` request parameter `X-Organization-Id`
  - removed the optional property `data/attributes/pay_on_relative` from the response with the `200` status
  - added `#/components/schemas/_collection_linkage` to the `data/relationships/custom_field_attachments` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_collection_linkage` to the `data/relationships/custom_field_people` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_collection_linkage` to the `data/relationships/invoice_attributions` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/attachment` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/bank_account` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/bill_from` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/bill_to` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/company` response property `anyOf` list for the response status `200`
  - …90 more
  - …this revision’s changelog is incomplete

---

[Operation](https://skmtc.dev/productive/apis/api-documentation/docs/api/v2/invoices/:id/finalize/patch.md) - [API](https://skmtc.dev/productive/apis/api-documentation.md) - [Page](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/invoices/:id/finalize/patch)