---
title: "Changes to List billing invoices"
method: GET
path: "/openmeter/billing/invoices"
---

# Changes to List billing invoices

`GET /openmeter/billing/invoices`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 107 revisions.

- **2026-09-21** (v3) `159bfd1e78cf`: 2 info
- **2026-09-07** (v3) `9082b60c6dd4`: 3 info
- **2026-08-31** (v3) `ae31232bc557`: 1 info
- **2026-08-06** (v3) `9bca44e2d61d`: 1 info
- **2026-07-17** (v3) `a10b6108f8f8`: 1 info
- **2026-07-06** (v3) `9d1396ec00b3`: 1 breaking, 19 info
- **2026-07-03** (v3) `3be06f269447`: 2 info
- **2026-06-30** (v3) `3db67b8766bf`: 1 info
- **2026-05-11** (v3) `9d0042cb3815`: 1 breaking

## Changes

- **2026-09-21** (v3) `159bfd1e78cf`: 2 info
  - added `#/components/schemas/TaxCodeConfig` to the `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/rate_card/allOf[#/components/schemas/BillingInvoiceLineRateCard]/tax_config` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/BillingRateCardTaxConfig` from the `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/rate_card/allOf[#/components/schemas/BillingInvoiceLineRateCard]/tax_config` response property `allOf` list for the response status `200`
- **2026-09-07** (v3) `9082b60c6dd4`: 3 info
  - added the optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/validation_issues/items/component` to the response with the `200` status
  - added `#/components/schemas/BillingValidationIssueSeverity` to the `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/validation_issues/items/severity` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/BillingInvoiceValidationIssueSeverity` from the `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/validation_issues/items/severity` response property `allOf` list for the response status `200`
- **2026-08-31** (v3) `ae31232bc557`: 1 info
  - added the optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/subscription/allOf[#/components/schemas/BillingSubscriptionReference]/name` to the response with the `200` status
- **2026-08-06** (v3) `9bca44e2d61d`: 1 info
  - added the optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/usage_quantity_detail` to the response with the `200` status
- **2026-07-17** (v3) `a10b6108f8f8`: 1 info
  - added the optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/rate_card/allOf[#/components/schemas/BillingInvoiceLineRateCard]/unit_config` to the response with the `200` status
- **2026-07-06** (v3) `9d1396ec00b3`: 1 breaking, 19 info
  - the response property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/id` became optional for the status `200`
  - added the optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/workflow/allOf[#/components/schemas/BillingInvoiceWorkflowSettings]/workflow/allOf[#/components/schemas/BillingInvoiceWorkflow]/invoicing/allOf[#/components/schemas/BillingInvoiceWorkflowInvoicingSettings]/due_after` to the response with the `200` status
  - the response optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines` became not read-only for the status `200`
  - the response optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/rate_card/allOf[#/components/schemas/BillingInvoiceLineRateCard]/discounts` became not read-only for the status `200`
  - the response optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/rate_card/allOf[#/components/schemas/BillingInvoiceLineRateCard]/feature_key` became not read-only for the status `200`
  - the response optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/rate_card/allOf[#/components/schemas/BillingInvoiceLineRateCard]/tax_config` became not read-only for the status `200`
  - the response optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/workflow/allOf[#/components/schemas/BillingInvoiceWorkflowSettings]/workflow/allOf[#/components/schemas/BillingInvoiceWorkflow]/invoicing` became not read-only for the status `200`
  - the response optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/workflow/allOf[#/components/schemas/BillingInvoiceWorkflowSettings]/workflow/allOf[#/components/schemas/BillingInvoiceWorkflow]/invoicing/allOf[#/components/schemas/BillingInvoiceWorkflowInvoicingSettings]/auto_advance` became not read-only for the status `200`
  - the response optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/workflow/allOf[#/components/schemas/BillingInvoiceWorkflowSettings]/workflow/allOf[#/components/schemas/BillingInvoiceWorkflow]/invoicing/allOf[#/components/schemas/BillingInvoiceWorkflowInvoicingSettings]/draft_period` became not read-only for the status `200`
  - the response optional property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/workflow/allOf[#/components/schemas/BillingInvoiceWorkflowSettings]/workflow/allOf[#/components/schemas/BillingInvoiceWorkflow]/payment` became not read-only for the status `200`
  - the response required property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/customer` became not read-only for the status `200`
  - the response required property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/id` became not read-only for the status `200`
  - the response required property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/rate_card` became not read-only for the status `200`
  - the response required property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/rate_card/allOf[#/components/schemas/BillingInvoiceLineRateCard]/price` became not read-only for the status `200`
  - the response required property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/service_period` became not read-only for the status `200`
  - the response required property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/lines/items/oneOf[#/components/schemas/BillingInvoiceStandardLine]/type` became not read-only for the status `200`
  - the response required property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/supplier` became not read-only for the status `200`
  - the response required property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/type` became not read-only for the status `200`
  - the response required property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/workflow` became not read-only for the status `200`
  - the response required property `data/items/oneOf[#/components/schemas/BillingInvoiceStandard]/workflow/allOf[#/components/schemas/BillingInvoiceWorkflowSettings]/workflow` became not read-only for the status `200`
- **2026-07-03** (v3) `3be06f269447`: 2 info
  - for the `query` request parameter `filter`, the format of property `customer_id/allOf[subschema #1: ULID Field Filter]/anyOf[subschema #2]/oeq` was generalized from `ArrayEncoding.commaDelimited` to no format
  - for the `query` request parameter `filter`, the format of property `status/allOf[subschema #1: String Field Filter Exact]/anyOf[subschema #2]/oeq` was generalized from `ArrayEncoding.commaDelimited` to no format
- **2026-06-30** (v3) `3db67b8766bf`: 1 info
  - endpoint added
- **2026-05-11** (v3) `9d0042cb3815`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/openmeterio/apis/openmeter-api/docs/openmeter/billing/invoices/get.md) · [API](https://skmtc.dev/openmeterio/apis/openmeter-api.md) · [Page](https://skmtc.dev/openmeterio/apis/openmeter-api/changes/openmeter/billing/invoices/get)