--- title: "Changes to List customer charges" method: GET path: "/openmeter/customers/{customerId}/charges" --- # Changes to List customer charges `GET /openmeter/customers/{customerId}/charges` > Every recorded change to this operation, newest first. ## Timeline Changed in 13 of 107 revisions. - **2026-09-21** (v3) `159bfd1e78cf`: 4 info - **2026-09-07** (v3) `9082b60c6dd4`: 8 info - **2026-09-03** (v3) `f767c87e22a3`: 10 info - **2026-08-31** (v3) `ae31232bc557`: 2 breaking, 2 warning, 19 info - **2026-08-27** (v3) `3e66c224fc9b`: 10 info - **2026-08-05** (v3) `443f0fc88c81`: 4 info - **2026-07-06** (v3) `0cab538c8c8f`: 2 info - **2026-07-03** (v3) `3be06f269447`: 1 info - **2026-06-26** (v3) `ec36b1a6d676`: 1 breaking, 3 info - **2026-06-18** (v3) `8ca194cd4b6f`: 2 info - **2026-06-17** (v3) `8663ae98fa72`: 15 info - **2026-05-26** (v3) `66c58f249315`: 4 info - **2026-05-11** (v3) `9d0042cb3815`: 2 breaking, 5 info ## Changes - **2026-09-21** (v3) `159bfd1e78cf`: 4 info - added `#/components/schemas/TaxCodeConfig` to the `data/items/oneOf[subschema #1: Flat fee charge]/subscription/allOf[#/components/schemas/SubscriptionOrReference]/oneOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/tax_config` response property `allOf` list for the response status `200` - added `#/components/schemas/TaxCodeConfig` to the `data/items/oneOf[subschema #2: Usage-based charge]/subscription/allOf[#/components/schemas/SubscriptionOrReference]/oneOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/tax_config` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingRateCardTaxConfig` from the `data/items/oneOf[subschema #1: Flat fee charge]/subscription/allOf[#/components/schemas/SubscriptionOrReference]/oneOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/tax_config` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingRateCardTaxConfig` from the `data/items/oneOf[subschema #2: Usage-based charge]/subscription/allOf[#/components/schemas/SubscriptionOrReference]/oneOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/tax_config` response property `allOf` list for the response status `200` - **2026-09-07** (v3) `9082b60c6dd4`: 8 info - added the optional property `data/items/oneOf[subschema #1: Flat fee charge]/realizations/items/invoice/allOf[#/components/schemas/ChargeRealizationInvoiceOrReference]/oneOf[subschema #1: Charge realization invoice]/validation_issues/items/component` to the response with the `200` status - added the optional property `data/items/oneOf[subschema #1: Flat fee charge]/validation_issues` to the response with the `200` status - added the optional property `data/items/oneOf[subschema #2: Usage-based charge]/realizations/items/invoice/allOf[#/components/schemas/ChargeRealizationInvoiceOrReference]/oneOf[subschema #1: Charge realization invoice]/validation_issues/items/component` to the response with the `200` status - added the optional property `data/items/oneOf[subschema #2: Usage-based charge]/validation_issues` to the response with the `200` status - added `#/components/schemas/BillingValidationIssueSeverity` to the `data/items/oneOf[subschema #1: Flat fee charge]/realizations/items/invoice/allOf[#/components/schemas/ChargeRealizationInvoiceOrReference]/oneOf[subschema #1: Charge realization invoice]/validation_issues/items/severity` response property `allOf` list for the response status `200` - added `#/components/schemas/BillingValidationIssueSeverity` to the `data/items/oneOf[subschema #2: Usage-based charge]/realizations/items/invoice/allOf[#/components/schemas/ChargeRealizationInvoiceOrReference]/oneOf[subschema #1: Charge realization invoice]/validation_issues/items/severity` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingInvoiceValidationIssueSeverity` from the `data/items/oneOf[subschema #1: Flat fee charge]/realizations/items/invoice/allOf[#/components/schemas/ChargeRealizationInvoiceOrReference]/oneOf[subschema #1: Charge realization invoice]/validation_issues/items/severity` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingInvoiceValidationIssueSeverity` from the `data/items/oneOf[subschema #2: Usage-based charge]/realizations/items/invoice/allOf[#/components/schemas/ChargeRealizationInvoiceOrReference]/oneOf[subschema #1: Charge realization invoice]/validation_issues/items/severity` response property `allOf` list for the response status `200` - **2026-09-03** (v3) `f767c87e22a3`: 10 info - added the optional property `data/items/oneOf[subschema #1: Flat fee charge]/resolved_cost_basis` to the response with the `200` status - added the optional property `data/items/oneOf[subschema #2: Usage-based charge]/resolved_cost_basis` to the response with the `200` status - added `#/components/schemas/BillingCurrencyAmount` to the `data/items/oneOf[subschema #1: Flat fee charge]/amount_after_proration` response property `allOf` list for the response status `200` - added `#/components/schemas/BillingCurrencyAmount` to the `data/items/oneOf[subschema #1: Flat fee charge]/system_intent/allOf[subschema #1: Flat fee system lifecycle controller charge intent]/amount_before_proration` response property `allOf` list for the response status `200` - added `#/components/schemas/BillingCurrencyCode` to the `data/items/oneOf[subschema #1: Flat fee charge]/currency` response property `allOf` list for the response status `200` - added `#/components/schemas/BillingCurrencyCode` to the `data/items/oneOf[subschema #2: Usage-based charge]/currency` response property `allOf` list for the response status `200` - removed `#/components/schemas/CurrencyAmount` from the `data/items/oneOf[subschema #1: Flat fee charge]/amount_after_proration` response property `allOf` list for the response status `200` - removed `#/components/schemas/CurrencyAmount` from the `data/items/oneOf[subschema #1: Flat fee charge]/system_intent/allOf[subschema #1: Flat fee system lifecycle controller charge intent]/amount_before_proration` response property `allOf` list for the response status `200` - removed `#/components/schemas/CurrencyCode` from the `data/items/oneOf[subschema #1: Flat fee charge]/currency` response property `allOf` list for the response status `200` - removed `#/components/schemas/CurrencyCode` from the `data/items/oneOf[subschema #2: Usage-based charge]/currency` response property `allOf` list for the response status `200` - **2026-08-31** (v3) `ae31232bc557`: 2 breaking, 2 warning, 19 info - removed the required property `data/items/oneOf[subschema #2: Usage-based charge]/feature_id` from the response with the `200` status - removed the required property `data/items/oneOf[subschema #2: Usage-based charge]/feature_key` from the response with the `200` status - removed the optional property `data/items/oneOf[subschema #1: Flat fee charge]/feature_id` from the response with the `200` status - removed the optional property `data/items/oneOf[subschema #1: Flat fee charge]/feature_key` from the response with the `200` status - added the enum value `customer` to the property `items/` of the `query` request parameter `expand` - added the enum value `feature` to the property `items/` of the `query` request parameter `expand` - added the enum value `realization.detailed_lines` to the property `items/` of the `query` request parameter `expand` - added the enum value `realization.invoice` to the property `items/` of the `query` request parameter `expand` - added the enum value `realization.totals` to the property `items/` of the `query` request parameter `expand` - added the enum value `subscription` to the property `items/` of the `query` request parameter `expand` - added the optional property `data/items/oneOf[subschema #1: Flat fee charge]/feature` to the response with the `200` status - added the optional property `data/items/oneOf[subschema #2: Usage-based charge]/usage` to the response with the `200` status - added `#/components/schemas/CustomerOrReference` to the `data/items/oneOf[subschema #1: Flat fee charge]/customer` response property `allOf` list for the response status `200` - added `#/components/schemas/CustomerOrReference` to the `data/items/oneOf[subschema #2: Usage-based charge]/customer` response property `allOf` list for the response status `200` - added `#/components/schemas/SubscriptionOrReference` to the `data/items/oneOf[subschema #1: Flat fee charge]/subscription` response property `allOf` list for the response status `200` - added `#/components/schemas/SubscriptionOrReference` to the `data/items/oneOf[subschema #2: Usage-based charge]/subscription` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingCustomerReference` from the `data/items/oneOf[subschema #1: Flat fee charge]/customer` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingCustomerReference` from the `data/items/oneOf[subschema #2: Usage-based charge]/customer` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingSubscriptionReference` from the `data/items/oneOf[subschema #1: Flat fee charge]/subscription` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingSubscriptionReference` from the `data/items/oneOf[subschema #2: Usage-based charge]/subscription` response property `allOf` list for the response status `200` - added the required property `data/items/oneOf[subschema #1: Flat fee charge]/realizations` to the response with the `200` status - added the required property `data/items/oneOf[subschema #2: Usage-based charge]/feature` to the response with the `200` status - added the required property `data/items/oneOf[subschema #2: Usage-based charge]/realizations` to the response with the `200` status - **2026-08-27** (v3) `3e66c224fc9b`: 10 info - added the optional property `data/items/oneOf[subschema #2: Usage-based charge]/commitments` to the response with the `200` status - added the optional property `data/items/oneOf[subschema #2: Usage-based charge]/system_intent/allOf[subschema #1: Usage-based system lifecycle controller charge intent]/commitments` to the response with the `200` status - added the optional property `data/items/oneOf[subschema #2: Usage-based charge]/system_intent/allOf[subschema #1: Usage-based system lifecycle controller charge intent]/unit_config` to the response with the `200` status - added the optional property `data/items/oneOf[subschema #2: Usage-based charge]/unit_config` to the response with the `200` status - added `#/components/schemas/BillingPriceFlat` to the `data/items/oneOf[subschema #1: Flat fee charge]/price` response property `allOf` list for the response status `200` - added `#/components/schemas/BillingPriceUsageBased` to the `data/items/oneOf[subschema #2: Usage-based charge]/price` response property `allOf` list for the response status `200` - added `#/components/schemas/BillingPriceUsageBased` to the `data/items/oneOf[subschema #2: Usage-based charge]/system_intent/allOf[subschema #1: Usage-based system lifecycle controller charge intent]/price` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingPrice` from the `data/items/oneOf[subschema #1: Flat fee charge]/price` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingPrice` from the `data/items/oneOf[subschema #2: Usage-based charge]/price` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingPrice` from the `data/items/oneOf[subschema #2: Usage-based charge]/system_intent/allOf[subschema #1: Usage-based system lifecycle controller charge intent]/price` response property `allOf` list for the response status `200` - **2026-08-05** (v3) `443f0fc88c81`: 4 info - added the optional property `data/items/oneOf[subschema #1: Flat fee charge]/feature_id` to the response with the `200` status - the response optional property `data/items/oneOf[subschema #1: Flat fee charge]/feature_key` became read-only for the status `200` - added the required property `data/items/oneOf[subschema #2: Usage-based charge]/feature_id` to the response with the `200` status - the response required property `data/items/oneOf[subschema #2: Usage-based charge]/feature_key` became read-only for the status `200` - **2026-07-06** (v3) `0cab538c8c8f`: 2 info - added the optional property `data/items/oneOf[subschema #1: Flat fee charge]/system_intent` to the response with the `200` status - added the optional property `data/items/oneOf[subschema #2: Usage-based charge]/system_intent` to the response with the `200` status - **2026-07-03** (v3) `3be06f269447`: 1 info - 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-26** (v3) `ec36b1a6d676`: 1 breaking, 3 info - added `#/components/schemas/BillingChargeFlatFee, #/components/schemas/BillingChargeUsageBased` to the `data/items/` response property `oneOf` list for the response status `200` - mapped value for discriminator key `flat_fee` changed from `#/components/schemas/BillingFlatFeeCharge` to `#/components/schemas/BillingChargeFlatFee` for `data/items/` response property for the response status `200` - mapped value for discriminator key `usage_based` changed from `#/components/schemas/BillingUsageBasedCharge` to `#/components/schemas/BillingChargeUsageBased` for `data/items/` response property for the response status `200` - removed `#/components/schemas/BillingFlatFeeCharge, #/components/schemas/BillingUsageBasedCharge` from the `data/items/` response property `oneOf` list for the response status `200` - **2026-06-18** (v3) `8ca194cd4b6f`: 2 info - api tag `OpenMeter Customers` added - api tag `OpenMeter Billing` removed - **2026-06-17** (v3) `8663ae98fa72`: 15 info - the response optional property `data/items/oneOf[subschema #1: Flat fee charge]/tax_config` became not read-only for the status `200` - the response optional property `data/items/oneOf[subschema #1: Flat fee charge]/unique_reference_id` became not read-only for the status `200` - the response optional property `data/items/oneOf[subschema #2: Usage-based charge]/tax_config` became not read-only for the status `200` - the response optional property `data/items/oneOf[subschema #2: Usage-based charge]/unique_reference_id` became not read-only for the status `200` - the response required property `data/items/oneOf[subschema #1: Flat fee charge]/currency` became not read-only for the status `200` - the response required property `data/items/oneOf[subschema #1: Flat fee charge]/invoice_at` became not read-only for the status `200` - the response required property `data/items/oneOf[subschema #1: Flat fee charge]/service_period` became not read-only for the status `200` - the response required property `data/items/oneOf[subschema #1: Flat fee charge]/settlement_mode` became not read-only for the status `200` - the response required property `data/items/oneOf[subschema #1: Flat fee charge]/type` became not read-only for the status `200` - the response required property `data/items/oneOf[subschema #2: Usage-based charge]/currency` became not read-only for the status `200` - the response required property `data/items/oneOf[subschema #2: Usage-based charge]/invoice_at` became not read-only for the status `200` - the response required property `data/items/oneOf[subschema #2: Usage-based charge]/price` became not read-only for the status `200` - the response required property `data/items/oneOf[subschema #2: Usage-based charge]/service_period` became not read-only for the status `200` - the response required property `data/items/oneOf[subschema #2: Usage-based charge]/settlement_mode` became not read-only for the status `200` - the response required property `data/items/oneOf[subschema #2: Usage-based charge]/type` became not read-only for the status `200` - **2026-05-26** (v3) `66c58f249315`: 4 info - added `#/components/schemas/TaxCodeReference` to the `data/items/oneOf[subschema #1: Flat fee charge]/tax_config/allOf[#/components/schemas/BillingTaxConfig]/tax_code` response property `allOf` list for the response status `200` - added `#/components/schemas/TaxCodeReference` to the `data/items/oneOf[subschema #2: Usage-based charge]/tax_config/allOf[#/components/schemas/BillingTaxConfig]/tax_code` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingTaxCodeReference` from the `data/items/oneOf[subschema #1: Flat fee charge]/tax_config/allOf[#/components/schemas/BillingTaxConfig]/tax_code` response property `allOf` list for the response status `200` - removed `#/components/schemas/BillingTaxCodeReference` from the `data/items/oneOf[subschema #2: Usage-based charge]/tax_config/allOf[#/components/schemas/BillingTaxConfig]/tax_code` response property `allOf` list for the response status `200` - **2026-05-11** (v3) `9d0042cb3815`: 2 breaking, 5 info - for the `query` request parameter `filter`, the format of property `status/allOf[subschema #1: String Field Filter Exact]/anyOf[subschema #2]/oeq` was specialized from no format to `ArrayEncoding.commaDelimited` - added `#/components/schemas/BillingFlatFeeCharge, #/components/schemas/BillingUsageBasedCharge` to the `data/items/` response property `oneOf` list for the response status `200` - api tag `OpenMeter Billing` added - api tag `OpenMeter Customers` removed - mapped value for discriminator key `flat_fee` changed from `#/components/schemas/BillingChargeFlatFee` to `#/components/schemas/BillingFlatFeeCharge` for `data/items/` response property for the response status `200` - mapped value for discriminator key `usage_based` changed from `#/components/schemas/BillingChargeUsageBased` to `#/components/schemas/BillingUsageBasedCharge` for `data/items/` response property for the response status `200` - removed `#/components/schemas/BillingChargeFlatFee, #/components/schemas/BillingChargeUsageBased` from the `data/items/` response property `oneOf` list for the response status `200` --- [Operation](https://skmtc.dev/openmeterio/apis/openmeter-api/docs/openmeter/customers/:customerId/charges/get.md) · [API](https://skmtc.dev/openmeterio/apis/openmeter-api.md) · [Page](https://skmtc.dev/openmeterio/apis/openmeter-api/changes/openmeter/customers/:customerId/charges/get)