---
title: "Changes to Create invoice"
method: POST
path: "/api/v1/services/invoices/invoice"
---

# Changes to Create invoice

`POST /api/v1/services/invoices/invoice`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 18 of 70 revisions.

- **2024-11-08** `dc03bb6c514d`: 2 info
- **2024-10-17** `f4284b424943`: 2 info
- **2024-03-22** `dbd561304b3b`: 1 info
- **2023-11-01** `f9f50dcb6417`: 1 info
- **2023-10-26** `2596aa00157e`: 1 breaking
- **2023-10-24** `20ef35372eae`: 1 breaking
- **2023-10-23** `aaef903178b6`: 3 warning, 1 info
- **2023-10-19** `33c43c32442a`: 1 breaking, 2 warning, 2 info
- **2023-10-12** `17b5f8ce2463`: 5 breaking, 6 warning, 7 info
- **2023-10-09** `c011b622e643`: 3 breaking, 1 warning, 3 info
- **2023-10-06** `5dc4b4b69eb9`: 2 warning
- **2023-10-05** `e993643541ef`: 1 info
- **2023-08-02** `c88a633eda12`: 1 breaking
- **2023-06-05** `06459bd5448a`: 3 info
- **2023-05-25** `f8f8efbd8b61`: 1 warning
- **2023-05-24** `77b1e11e0732`: 1 info
- **2023-05-23** `d9f1821847be`: 2 info
- **2023-05-16** `46e5d7e75197`: 1 info

## Changes

- **2024-11-08** `dc03bb6c514d`: 2 info
  - the `currency` request property default value `TON` was removed
  - the `currency` response's property default value `TON` was removed for the status `201`
- **2024-10-17** `f4284b424943`: 2 info
  - added the new optional request property `currency`
  - added the required property `currency` to the response with the `201` status
- **2024-03-22** `dbd561304b3b`: 1 info
  - added the optional property `info` to the response with the `201` status
- **2023-11-01** `f9f50dcb6417`: 1 info
  - added the media type `application/json` for the response with the status `201`
- **2023-10-26** `2596aa00157e`: 1 breaking
  - removed the media type `application/json` for the response with the status `201`
- **2023-10-24** `20ef35372eae`: 1 breaking
  - the `invoice/overpayment` response's property type changed from `number` to `string` for status `201`
- **2023-10-23** `aaef903178b6`: 3 warning, 1 info
  - removed the optional property `invoice/date_refund` from the response with the `201` status
  - removed the optional property `invoice/refund_amount` from the response with the `201` status
  - removed the optional property `invoice/refunded` from the response with the `201` status
  - the `query` request parameter `app_id` became optional
- **2023-10-19** `33c43c32442a`: 1 breaking, 2 warning, 2 info
  - removed the required property `invoice/life_time` from the response with the `201` status
  - removed the optional property `invoice/date_cancelled` from the response with the `201` status
  - removed the optional property `invoice/date_paid` from the response with the `201` status
  - added the required property `invoice/date_change` to the response with the `201` status
  - added the required property `invoice/date_expire` to the response with the `201` status
- **2023-10-12** `17b5f8ce2463`: 5 breaking, 6 warning, 7 info
  - the `amount` request property type changed from `integer` to `string`, and format from `int64` to no format
  - the `invoice/amount` response's property type changed from `integer` to `string`, and format from `int64` to no format for status `201`
  - removed the required property `invoice/app_description` from the response with the `201` status
  - removed the required property `invoice/recipient_address` from the response with the `201` status
  - removed the required property `invoice/subtract_fee_from_amount` from the response with the `201` status
  - removed the optional property `invoice/date_cancel` from the response with the `201` status
  - removed the optional property `invoice/paid_address` from the response with the `201` status
  - added the new `cancelled` enum value to the `invoice/status` response property for the response status `201`
  - added the new `expired` enum value to the `invoice/status` response property for the response status `201`
  - added the new `paid` enum value to the `invoice/status` response property for the response status `201`
  - added the new `pending` enum value to the `invoice/status` response property for the response status `201`
  - added the optional property `invoice/date_cancelled` to the response with the `201` status
  - added the optional property `invoice/paid_by_address` to the response with the `201` status
  - removed the `cancel_status` enum value from the `invoice/status` response property for the response status `201`
  - removed the `expired_status` enum value from the `invoice/status` response property for the response status `201`
  - removed the `pending_status` enum value from the `invoice/status` response property for the response status `201`
  - removed the `success_status` enum value from the `invoice/status` response property for the response status `201`
  - added the required property `invoice/pay_to_address` to the response with the `201` status
- **2023-10-09** `c011b622e643`: 3 breaking, 1 warning, 3 info
  - the `invoice/date_cancel` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `201`
  - the `invoice/date_create` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `201`
  - the `invoice/date_paid` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `201`
  - removed the optional property `invoice/refunded_amount` from the response with the `201` status
  - added the optional property `invoice/date_refund` to the response with the `201` status
  - added the optional property `invoice/refund_amount` to the response with the `201` status
  - added the optional property `invoice/refunded` to the response with the `201` status
- **2023-10-06** `5dc4b4b69eb9`: 2 warning
  - removed the request property `recipient_address`
  - removed the request property `subtract_fee_from_amount`
- **2023-10-05** `e993643541ef`: 1 info
  - endpoint added
- **2023-08-02** `c88a633eda12`: 1 breaking
  - api path removed without deprecation
- **2023-06-05** `06459bd5448a`: 3 info
  - added the optional property `invoice/date_cancel` to the response with the `201` status
  - added the required property `invoice/app_description` to the response with the `201` status
  - added the required property `invoice/app_name` to the response with the `201` status
- **2023-05-25** `f8f8efbd8b61`: 1 warning
  - deleted the `query` request parameter `project_id`
- **2023-05-24** `77b1e11e0732`: 1 info
  - added the optional property `invoice/paid_address` to the response with the `201` status
- **2023-05-23** `d9f1821847be`: 2 info
  - added the optional property `invoice/date_paid` to the response with the `201` status
  - added the required property `invoice/recipient_address` to the response with the `201` status
- **2023-05-16** `46e5d7e75197`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/tonkeeper/apis/rest-api-to-ton-console/docs/api/v1/services/invoices/invoice/post.md) - [API](https://skmtc.dev/tonkeeper/apis/rest-api-to-ton-console.md) - [Page](https://skmtc.dev/tonkeeper/apis/rest-api-to-ton-console/changes/api/v1/services/invoices/invoice/post)
