---
title: "Changes to Retrieve Bill"
method: GET
path: "/organizations/{orgId}/bills/{id}"
---

# Changes to Retrieve Bill

`GET /organizations/{orgId}/bills/{id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 10 revisions.

- **2025-12-03** `ac93d1a9e6d9` — 1 warning, 1 info
- **2025-08-01** `9f9e5f3dbde7` — 2 breaking, 10 info
- **2025-03-03** `9beb1e1df3bd` — 1 info
- **2025-02-26** `6c3e1a3cfb8f` — 1 info
- **2025-02-21** `d064a12d0d93` — 1 info
- **2025-02-04** `9433593378b5` — 20 warning, 1 info

## Changes

- **2025-12-03** `ac93d1a9e6d9` — 1 warning, 1 info
  - added the new `AD_HOC` enum value to the `lineItems/items/lineItemType` response property for the response status `200`
  - added the optional property `statementStale` to the response with the `200` status
- **2025-08-01** `9f9e5f3dbde7` — 2 breaking, 10 info
  - the response property `allOf[#/components/schemas/AbstractBillResponse]/allOf[#/components/schemas/AbstractResponse]/version` became optional for the status `200`
  - the response property `allOf[#/components/schemas/AbstractResponse]/version` became optional for the status `200`
  - added the new optional `query` request parameter `additional`
  - added the optional property `approvedBy` to the response with the `200` status
  - added the optional property `dtApproved` to the response with the `200` status
  - added the optional property `dtLocked` to the response with the `200` status
  - added the optional property `lineItems/items/accountingProductCode` to the response with the `200` status
  - added the optional property `lineItems/items/accountingProductId` to the response with the `200` status
  - added the optional property `lineItems/items/accountingProductName` to the response with the `200` status
  - added the optional property `lineItems/items/additional` to the response with the `200` status
  - added the optional property `lineItems/items/usagePerPricingBand/items/convertedBandSubtotal` to the response with the `200` status
  - added the optional property `lockedBy` to the response with the `200` status
- **2025-03-03** `9beb1e1df3bd` — 1 info
  - added the optional property `lineItems/items/chargeId` to the response with the `200` status
- **2025-02-26** `6c3e1a3cfb8f` — 1 info
  - added the optional property `lineItems/items/group` to the response with the `200` status
- **2025-02-21** `d064a12d0d93` — 1 info
  - the `timezone` response's property default value `UTC` was added for the status `200`
- **2025-02-04** `9433593378b5` — 20 warning, 1 info
  - removed the optional property `accountCode` from the response with the `200` status
  - removed the optional property `accountId` from the response with the `200` status
  - removed the optional property `billDate` from the response with the `200` status
  - removed the optional property `billFrequencyInterval` from the response with the `200` status
  - removed the optional property `billJobId` from the response with the `200` status
  - removed the optional property `billingFrequency` from the response with the `200` status
  - removed the optional property `createdDate` from the response with the `200` status
  - removed the optional property `currency` from the response with the `200` status
  - removed the optional property `currencyConversions` from the response with the `200` status
  - removed the optional property `dueDate` from the response with the `200` status
  - removed the optional property `endDate` from the response with the `200` status
  - removed the optional property `endDateTimeUTC` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `lastCalculatedDate` from the response with the `200` status
  - removed the optional property `locked` from the response with the `200` status
  - removed the optional property `startDate` from the response with the `200` status
  - removed the optional property `startDateTimeUTC` from the response with the `200` status
  - removed the optional property `status` from the response with the `200` status
  - removed the optional property `timezone` from the response with the `200` status
  - removed the optional property `version` from the response with the `200` status
  - added `#/components/schemas/AbstractBillResponse, #/components/schemas/AbstractResponse` to the response body `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/m3ter-com/apis/m3ter-api/docs/organizations/:orgId/bills/:id/get.md) · [API](https://skmtc.dev/m3ter-com/apis/m3ter-api.md) · [Page](https://skmtc.dev/m3ter-com/apis/m3ter-api/changes/organizations/:orgId/bills/:id/get)
