---
title: "Create customer charge"
method: POST
path: "/v3/openmeter/customers/{customerId}/charges"
tags: ["OpenMeter Customers"]
---

# Create customer charge

`POST /v3/openmeter/customers/{customerId}/charges`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v3/openmeter/customers/{customerId}/charges`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

**Pre-release Endpoint**
This endpoint is currently in beta and is subject to change.

Create customer charge.

## Path parameters

- `customerId` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).

## Request body

- union: Customer charge.
  - object: Flat fee charge create request.
    - `name` string, required: Display name of the resource. Between 1 and 256 characters.
    - `description` string: Optional description of the resource. Maximum 1024 characters.
    - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `type` 'flat_fee', required: The type of the charge.
    - `currency` union, required: The currency of the charge.
      - string: Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. Custom three-letter currency codes are also supported for convenience.
      - string: Custom currency code. It should be a unique code but not conflicting with any existing fiat currency codes.
    - `cost_basis` union: Defines how a custom-currency charge is converted into its fiat invoice currency; the resolved rate is exposed through `resolved_cost_basis`. Required when `currency` is custom and the charge settles as `credit_then_invoice`; must be omitted otherwise.
      - object: Cost basis resolved at the charge's full service period start.
        - `type` 'dynamic', required: Discriminator selecting the cost basis mode.
        - `fiat_currency` string, required: The fiat currency the charge amount is converted into for invoicing.
      - object: Cost basis pinned to a specific cost basis resource of the custom currency.
        - `type` 'pinned', required: Discriminator selecting the cost basis mode.
        - `fiat_currency` string, required: The fiat currency the charge amount is converted into for invoicing.
        - `cost_basis_id` string, required: ID of the custom currency's cost basis resource to pin.
      - object: Cost basis with an explicit conversion rate supplied with the charge.
        - `type` 'manual', required: Discriminator selecting the cost basis mode.
        - `fiat_currency` string: The fiat currency the charge amount is converted into for invoicing.
        - `rate` string, required: Fiat amount per one unit of the custom currency.
    - `invoice_at` string, date-time, required: The timestamp when the charge is intended to be invoiced.
    - `service_period` object, required: The effective service period covered by the charge.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
    - `unique_reference_id` string: Unique reference ID of the charge.
    - `settlement_mode` 'credit_then_invoice' | 'credit_only', required: Settlement mode of the charge.
    - `tax_config` object: Tax configuration of the charge.
      - `behavior` 'inclusive' | 'exclusive': Tax behavior. If not specified the billing profile is used to determine the tax behavior. If not specified in the billing profile, the provider's default behavior is used.
      - `stripe` object: Stripe tax config.
        - `code` string, required: Product [tax code](https://docs.stripe.com/tax/tax-codes).
      - `external_invoicing` object: External invoicing tax config.
        - `code` string, required: The tax code should be interpreted by the external invoicing provider.
      - `tax_code_id` string: Tax code ID.
      - `tax_code` object: Tax code reference. When both `tax_code` and `tax_code_id` are provided, `tax_code` takes precedence. When `stripe.code` is also provided, `tax_code` still wins and `stripe.code` is ignored.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `payment_term` 'in_advance' | 'in_arrears', required: Payment term of the flat fee charge.
    - `discounts` object: The discounts applied to the charge.
      - `percentage` number: Percentage discount applied to the price (0–100).
    - `proration_configuration` object, required: The proration configuration of the charge.
      - `mode` 'no_proration' | 'prorate_prices', required: The proration mode of the rate card.
    - `amount_before_proration` object, required: The amount before proration of the charge.
      - `amount` string, required: The amount as an arbitrary-precision decimal string.
      - `currency` union, required: The fiat or custom currency code of the amount.
        - string: Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. Custom three-letter currency codes are also supported for convenience.
        - string: Custom currency code. It should be a unique code but not conflicting with any existing fiat currency codes.
    - `feature` object: A reference to the feature associated with the charge, when applicable.
      - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `full_service_period` object: The full, unprorated service period of the charge.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
    - `billing_period` object: The billing period the charge belongs to.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
  - object: Usage-based charge create request.
    - `name` string, required: Display name of the resource. Between 1 and 256 characters.
    - `description` string: Optional description of the resource. Maximum 1024 characters.
    - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `type` 'usage_based', required: The type of the charge.
    - `currency` union, required: The currency of the charge.
      - string: Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. Custom three-letter currency codes are also supported for convenience.
      - string: Custom currency code. It should be a unique code but not conflicting with any existing fiat currency codes.
    - `cost_basis` union: Defines how a custom-currency charge is converted into its fiat invoice currency; the resolved rate is exposed through `resolved_cost_basis`. Required when `currency` is custom and the charge settles as `credit_then_invoice`; must be omitted otherwise.
      - object: Cost basis resolved at the charge's full service period start.
        - `type` 'dynamic', required: Discriminator selecting the cost basis mode.
        - `fiat_currency` string, required: The fiat currency the charge amount is converted into for invoicing.
      - object: Cost basis pinned to a specific cost basis resource of the custom currency.
        - `type` 'pinned', required: Discriminator selecting the cost basis mode.
        - `fiat_currency` string, required: The fiat currency the charge amount is converted into for invoicing.
        - `cost_basis_id` string, required: ID of the custom currency's cost basis resource to pin.
      - object: Cost basis with an explicit conversion rate supplied with the charge.
        - `type` 'manual', required: Discriminator selecting the cost basis mode.
        - `fiat_currency` string: The fiat currency the charge amount is converted into for invoicing.
        - `rate` string, required: Fiat amount per one unit of the custom currency.
    - `invoice_at` string, date-time, required: The timestamp when the charge is intended to be invoiced.
    - `service_period` object, required: The effective service period covered by the charge.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
    - `unique_reference_id` string: Unique reference ID of the charge.
    - `settlement_mode` 'credit_then_invoice' | 'credit_only', required: Settlement mode of the charge.
    - `tax_config` object: Tax configuration of the charge.
      - `behavior` 'inclusive' | 'exclusive': Tax behavior. If not specified the billing profile is used to determine the tax behavior. If not specified in the billing profile, the provider's default behavior is used.
      - `stripe` object: Stripe tax config.
        - `code` string, required: Product [tax code](https://docs.stripe.com/tax/tax-codes).
      - `external_invoicing` object: External invoicing tax config.
        - `code` string, required: The tax code should be interpreted by the external invoicing provider.
      - `tax_code_id` string: Tax code ID.
      - `tax_code` object: Tax code reference. When both `tax_code` and `tax_code_id` are provided, `tax_code` takes precedence. When `stripe.code` is also provided, `tax_code` still wins and `stripe.code` is ignored.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `discounts` object: Discounts applied to the usage-based charge.
      - `percentage` number: Percentage discount applied to the price (0–100).
      - `usage` string: Number of usage units granted free before billing starts. Only applies to usage-based lines (not flat fees). Usage is treated as zero until this amount is exhausted.
    - `price` union, required: The price of the charge. `free` prices are rejected on create: a usage-based charge always carries a concrete price.
      - object: Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the object, billing units are the converted quantities (e.g. GB instead of bytes).
        - `type` 'unit', required: The type of the price.
        - `amount` string, required: The amount of the unit price.
      - object: Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.
        - `type` 'graduated', required: The type of the price.
        - `tiers` BillingPriceTier[], required: The tiers of the graduated price. At least one tier is required.
          - `up_to_amount` string: Up to and including this quantity will be contained in the tier. If undefined, the tier is open-ended (the last tier).
          - `flat_price` object: The flat price component of the tier. Charged once when the tier is entered.
            - `type` 'flat', required: The type of the price.
            - `amount` string, required: The amount of the flat price.
          - `unit_price` object: The unit price component of the tier. Charged per billing unit within the tier.
            - `type` 'unit', required: The type of the price.
            - `amount` string, required: The amount of the unit price.
      - object: Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.
        - `type` 'volume', required: The type of the price.
        - `tiers` BillingPriceTier[], required: The tiers of the volume price. At least one tier is required.
          - `up_to_amount` string: Up to and including this quantity will be contained in the tier. If undefined, the tier is open-ended (the last tier).
          - `flat_price` object: The flat price component of the tier. Charged once when the tier is entered.
            - `type` 'flat', required: The type of the price.
            - `amount` string, required: The amount of the flat price.
          - `unit_price` object: The unit price component of the tier. Charged per billing unit within the tier.
            - `type` 'unit', required: The type of the price.
            - `amount` string, required: The amount of the unit price.
    - `commitments` object: Spend commitments for the charge.
      - `minimum_amount` string: The customer is committed to spend at least the amount.
      - `maximum_amount` string: The customer is limited to spend at most the amount.
    - `unit_config` object: Unit conversion configuration for the charge. Synthesized on read for charges created from v1 dynamic or package prices: dynamic prices map to a unit price with a multiply unit config, and package prices map to a unit price with a divide unit config. Accepted on create only when the UnitConfig feature is enabled on the deployment; otherwise rejected.
      - `operation` 'divide' | 'multiply', required: The arithmetic operation to apply to the raw metered quantity.
      - `conversion_factor` string, required: The factor used in the conversion operation. - For `divide`: `converted = raw / conversionFactor`. - For `multiply`: `converted = raw × conversionFactor`. Must be a positive non-zero value.
      - `rounding` 'ceiling' | 'floor' | 'half_up' | 'none': The rounding mode applied to the converted quantity for invoicing. Defaults to none (no rounding). Entitlement checks always use the precise (unrounded) value.
      - `precision` integer: The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers).
      - `display_unit` string: A human-readable label for the converted unit shown on invoices and in the customer portal (e.g., "GB", "hours", "M tokens"). Optional. When omitted, no unit label is rendered.
    - `feature` object, required: A reference to the feature associated with the charge.
      - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `full_service_period` object: The full, unprorated service period of the charge.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
    - `billing_period` object: The billing period the charge belongs to.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.

## Response `201`

Charge created response.

- union: Customer charge.
  - object: A flat fee charge for a customer.
    - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `name` string, required: Display name of the resource. Between 1 and 256 characters.
    - `description` string: Optional description of the resource. Maximum 1024 characters.
    - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
    - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
    - `type` 'flat_fee', required: The type of the charge.
    - `customer` union, required: The customer owning the charge. By default, only the `id` of the customer is returned. For more details use the `customer` expand.
      - BillingCustomer: Customers can be individuals or organizations that can subscribe to plans and have access to features.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
        - `name` string, required: Display name of the resource. Between 1 and 256 characters.
        - `description` string: Optional description of the resource. Maximum 1024 characters.
        - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
        - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
        - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
        - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
        - `key` string, required: ExternalResourceKey is a unique string that is used to identify a resource in an external system.
        - `usage_attribution` object: Mapping to attribute metered usage to the customer by the event subject.
          - `subject_keys` UsageAttributionSubjectKey[], required: The subjects that are attributed to the customer. Can be empty when no usage event subjects are associated with the customer.
        - `primary_email` string: The primary email address of the customer.
        - `currency` string: Currency of the customer. Used for billing, tax and invoicing.
        - `billing_address` object: The billing address of the customer. Used for tax and invoicing.
          - `country` string: Country code in [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html) alpha-2 format.
          - `postal_code` string: Postal code.
          - `state` string: State or province.
          - `city` string: City.
          - `line1` string: First line of the address.
          - `line2` string: Second line of the address.
          - `phone_number` string: Phone number.
      - CustomerReference: Customer reference.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `lifecycle_controller` 'system' | 'manual', required: Indicates whether the charge lifecycle is controlled by the system or manually overridden by the API user.
    - `subscription` union: The subscription that originated the charge, when the charge was created from a subscription item. By default, only the `id`, `phase.id`, `phase.item.id` of the subscription is returned. For more details use the `subscription` expand.
      - BillingSubscription: Subscription.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
        - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
        - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
        - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
        - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
        - `name` string, required: Display name of the subscription. Defaults to the plan name when the subscription is created from a plan.
        - `description` string: Optional description of the subscription.
        - `active_from` string, date-time, required: An ISO-8601 timestamp representation of when the subscription became (or will become) active.
        - `active_to` string, date-time: An ISO-8601 timestamp representation of when the subscription stops being active. Open-ended when not set.
        - `customer_id` string, required: The customer ID of the subscription.
        - `plan_id` string: The plan ID of the subscription. Set if subscription is created from a plan.
        - `plan` object: The plan the subscription was created from, if any. Includes the plan key and version so clients can resolve the exact plan revision.
          - `id` string, required: The plan ID (exact revision).
          - `key` string, required: The plan key. References the plan across versions.
          - `version` integer, required: The plan version.
        - `invoice_currency` string, required: The fiat currency in which the subscription is invoiced.
        - `cost_basis_mode` 'dynamic' | 'pinned', required: Controls whether custom-currency cost bases are resolved dynamically or pinned when their currency pair is introduced to the subscription.
        - `cost_basis_pins` BillingSubscriptionCostBasisPin[], required: Cost bases pinned to custom-currency pairs for this subscription.
          - `custom_currency_id` string, required: The managed custom currency ID.
          - `invoice_currency` string, required: The fiat currency in which the subscription is invoiced.
          - `cost_basis_id` string, required: The pinned cost basis resource ID.
        - `billing_cadence` string, ISO8601, required: The billing cadence of the subscription in ISO-8601 duration format. Defines how often the customer is billed. Examples: `P1M` (monthly), `P3M` (quarterly), `P1Y` (annually).
        - `pro_rating_config` object: The pro-rating configuration of the subscription.
          - `enabled` boolean, required: Whether pro-rating is enabled.
          - `mode` 'no_proration' | 'prorate_prices', required: How pro-rating is calculated when enabled.
        - `billing_anchor` string, date-time, required: A billing anchor is the fixed point in time that determines the subscription's recurring billing cycle. It affects when charges occur and how prorations are calculated. Common anchors: - Calendar month (1st of each month): `2025-01-01T00:00:00Z` - Subscription anniversary (day customer signed up) - Custom date (customer-specified day)
        - `status` 'active' | 'inactive' | 'canceled' | 'scheduled', required: The status of the subscription.
        - `settlement_mode` 'credit_then_invoice' | 'credit_only': Settlement mode for billing. Values: - `credit_then_invoice`: Credits are applied first, then any remainder is invoiced. - `credit_only`: Usage is settled exclusively against credits.
        - `current_period` object: The current aligned billing period. Present only when the subscription is active and aligned.
          - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
          - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
        - `phases` BillingSubscriptionPhase[], required: The phases of the subscription in chronological order. A phase groups the rate cards that are in effect for a segment of the subscription's lifetime.
          - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
          - `name` string, required: Display name of the resource. Between 1 and 256 characters.
          - `description` string: Optional description of the resource. Maximum 1024 characters.
          - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
          - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
          - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
          - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
          - `key` string, required: A key is a unique string that is used to identify a resource.
          - `active_from` string, date-time, required: An ISO-8601 timestamp representation of when the phase becomes active.
          - `active_to` string, date-time: An ISO-8601 timestamp representation of when the phase stops being active. Open-ended for the last phase.
          - `items` BillingSubscriptionItem[], required: The rate cards in effect for this phase, resolved to the version active at the queried time (the currently active version for the current phase, the first version for future phases, and the last version for past phases).
            - `id` string, required: The unique identifier of the subscription item instance.
            - `active_from` string, date-time, required: An ISO-8601 timestamp representation of when this item version becomes active.
            - `active_to` string, date-time: An ISO-8601 timestamp representation of when this item version stops being active.
            - `rate_card` object, required: The rate card describing what the customer gets and pays for this item.
              - …
      - BillingSubscriptionReference: Subscription reference represents a reference to the specific subscription item this entity represents.
        - `id` string, required: The ID of the subscription.
        - `name` string: The display name of the subscription. Only populated where the referencing endpoint documents a `subscription` expand that resolves it.
        - `phase` object, required: The phase of the subscription.
          - `id` string, required: The ID of the phase.
          - `item` object, required: The item of the phase.
            - `id` string, required: The ID of the item.
    - `currency` union, required: The currency of the charge.
      - string: Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. Custom three-letter currency codes are also supported for convenience.
      - string: Custom currency code. It should be a unique code but not conflicting with any existing fiat currency codes.
    - `resolved_cost_basis` object: The resolved fiat conversion rate of a custom-currency charge. Resolution depends on costbasis type: dynamic is resolved when charge becomes active, all other types resolved on creation.
      - `fiat_currency` string, required: The fiat currency the charge amount is converted into for invoicing.
      - `rate` string, required: Fiat amount per one unit of the custom currency.
      - `cost_basis_id` string: ID of the custom currency's cost basis resource the rate was taken from. Absent for manual cost bases.
      - `resolved_at` string, date-time, required: When the rate was resolved.
    - `status` 'created' | 'active' | 'final' | 'deleted', required: The lifecycle status of the charge.
    - `validation_issues` BillingValidationIssue[]: Validation issues found while processing the charge. Present only when there are one or more validation findings. An empty list is omitted.
      - `code` string, required: Machine-readable error code.
      - `message` string, required: Human-readable description of the error.
      - `attributes` object: Additional structured context.
      - `severity` 'critical' | 'warning', required: Severity of the validation issue.
      - `field` string: JSON path to the field that caused the validation issue, if applicable.
      - `component` string: Component that reported the validation issue, if applicable.
    - `invoice_at` string, date-time, required: The timestamp when the charge is intended to be invoiced.
    - `service_period` object, required: The effective service period covered by the charge.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
    - `full_service_period` object, required: The full, unprorated service period of the charge.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
    - `billing_period` object, required: The billing period the charge belongs to.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
    - `advance_after` string, date-time: The earliest time when the charge should be advanced again by background processing.
    - `unique_reference_id` string: Unique reference ID of the charge.
    - `settlement_mode` 'credit_then_invoice' | 'credit_only', required: Settlement mode of the charge.
    - `tax_config` object: Tax configuration of the charge.
      - `behavior` 'inclusive' | 'exclusive': Tax behavior. If not specified the billing profile is used to determine the tax behavior. If not specified in the billing profile, the provider's default behavior is used.
      - `stripe` object: Stripe tax config.
        - `code` string, required: Product [tax code](https://docs.stripe.com/tax/tax-codes).
      - `external_invoicing` object: External invoicing tax config.
        - `code` string, required: The tax code should be interpreted by the external invoicing provider.
      - `tax_code_id` string: Tax code ID.
      - `tax_code` object: Tax code reference. When both `tax_code` and `tax_code_id` are provided, `tax_code` takes precedence. When `stripe.code` is also provided, `tax_code` still wins and `stripe.code` is ignored.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `realizations` BillingChargeRealization[], required: The realization runs of the charge, sorted by `created_at`.
      - `id` string: The ID of the realization run. Not present on `outstanding` entries, which are projections rather than persisted runs.
      - `line_id` string: The ID of the invoice line this realization was booked to, when the realization has been invoiced.
      - `invoice` union: The reference of the invoice related to the realization.
        - BillingChargeRealizationInvoice: The invoice a charge realization was booked to, embedded as a header. Matches the standard invoice entity, except that it carries no `customer` snapshot (the charge context already identifies the customer) and `lines` are never populated (the realization itself is the line-level breakdown). The shared invoice contract stays untouched: this model exists so the charges API can slim the embedding without loosening the invoices API.
          - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
          - `description` string: Optional description of the resource. Maximum 1024 characters.
          - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
          - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
          - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
          - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
          - `number` string, required: Human-readable invoice number generated by the invoicing app.
          - `currency` string, required: Three-letter ISO 4217 currency code for the invoice.
          - `supplier` object, required: Snapshot of the supplier's contact information at the time the invoice was issued.
            - `name` string: Legal name or representation of the party.
            - `tax_id` object: The entity's legal identification used for tax purposes. They may have other numbers, but we're only interested in those valid for tax purposes.
              - …
            - `addresses` object: Address for where information should be sent if needed.
              - …
            - `id` string: Unique identifier for the party.
          - `totals` object, required: Aggregated financial totals for the invoice.
            - `amount` string, required: The total value of the resource before taxes, discounts and commitments.
            - `taxes_total` string, required: The total tax amount applied to the resource.
            - `taxes_inclusive_total` string, required: The total tax amount already included in the resource amount.
            - `taxes_exclusive_total` string, required: The total tax amount added on top of the resource amount.
            - `charges_total` string, required: The total amount contributed by additional charges.
            - `discounts_total` string, required: The total amount deducted through discounts.
            - `credits_total` string, required: The total amount deducted through credits before taxes are applied.
            - `total` string, required: The final total value of the resource after taxes, discounts and commitments.
          - `service_period` object, required: The service period covered by this invoice. For flat fee the service period can be empty which means `from` will be equals to `to`. In other cases those fields will be filled with the actual service period.
            - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
            - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
          - `validation_issues` BillingValidationIssue[]: Validation issues found during invoice processing. Present only when there are one or more validation findings. An empty list is omitted.
            - `code` string, required: Machine-readable error code.
            - `message` string, required: Human-readable description of the error.
            - `attributes` object: Additional structured context.
            - `severity` 'critical' | 'warning', required: Severity of the validation issue.
            - `field` string: JSON path to the field that caused the validation issue, if applicable.
            - `component` string: Component that reported the validation issue, if applicable.
          - `external_references` object: External identifiers assigned to this invoice by third-party systems.
            - `invoicing_id` string: The ID assigned by the external invoicing app (e.g. Stripe invoice ID).
            - `payment_id` string: The ID assigned by the external payment app (e.g. Stripe payment intent ID).
          - `type` 'standard', required: Discriminator field identifying this as a standard invoice.
          - `status` 'draft' | 'issuing' | 'issued' | 'payment_processing' | 'overdue' | 'paid' | 'uncollectible' | 'voided', required: Current lifecycle status of the invoice.
          - `status_details` object, required: Detailed status information including available actions and workflow state.
            - `immutable` boolean, required: Whether the invoice is immutable (i.e. cannot be modified or deleted).
            - `failed` boolean, required: Whether the invoice is in a failed state.
            - `extended_status` string, required: Fine-grained internal status string providing additional workflow detail beyond the top-level status enum.
            - `available_actions` object, required: The set of state-transition actions currently available for this invoice.
              - …
          - `issued_at` string, date-time: Timestamp when the invoice was issued to the customer.
          - `draft_until` string, date-time: Timestamp until which the invoice remains in draft state. The invoice advances automatically once this time is reached.
          - `quantity_snapshotted_at` string, date-time: Timestamp when usage quantities were last snapshotted for this invoice.
          - `collection_at` string, date-time: Timestamp when collection was initiated for this invoice.
          - `due_at` string, date-time: Timestamp when payment is due.
          - `sent_to_customer_at` string, date-time: Timestamp when the invoice was sent to the customer.
          - `workflow` object, required: Workflow configuration snapshot captured at invoice creation time.
            - `apps` object: The apps that will be used to orchestrate the invoice's workflow.
              - …
            - `source_billing_profile` object, required: The billing profile that was the source of this workflow snapshot.
              - …
            - `workflow` object, required: The workflow configuration that was active when the invoice was created. Only the fields that are meaningful at the per-invoice level are included: invoicing behaviour (auto-advance, draft period) and payment settings (collection method, due date). Profile-wide settings such as collection alignment, progressive billing, and tax policy are omitted.
              - …
        - ChargeRealizationInvoiceReference: ChargeRealizationInvoice reference.
          - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
      - `type` 'final_realization' | 'partial_invoice' | 'outstanding' | 'voided', required: The type of the realization run.
      - `service_period` object, required: The service period covered by this realization run.
        - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
        - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
      - `usage` string: The metered usage quantity this realization run accounts for. Only present on usage-based charges; flat fees are not metered, so their realizations carry no usage. Booked entries report a signed delta: a negative value states a downward usage correction (or a voided run that snapshotted behind its live neighbors) instead of masking it as zero. On an `outstanding` entry this is `0` unless the `real_time_usage` expand is applied, in which case it is the not-yet-booked remainder of the live metering read (never negative).
      - `payment` object: The payment state of the realization, when the charge requires a fiat transaction to settle.
        - `status` 'authorized' | 'settled', required: The settlement status of the payment.
      - `totals` object: Financial totals for the realization run, including credit allocations. Requires the `realization.totals` expand.
        - `amount` string, required: The total value of the resource before taxes, discounts and commitments.
        - `taxes_total` string, required: The total tax amount applied to the resource.
        - `taxes_inclusive_total` string, required: The total tax amount already included in the resource amount.
        - `taxes_exclusive_total` string, required: The total tax amount added on top of the resource amount.
        - `charges_total` string, required: The total amount contributed by additional charges.
        - `discounts_total` string, required: The total amount deducted through discounts.
        - `credits_total` string, required: The total amount deducted through credits before taxes are applied.
        - `total` string, required: The final total value of the resource after taxes, discounts and commitments.
      - `detailed_lines` BillingChargeRealizationDetailedLine[]: The detailed (rated) lines produced by the realization run. Requires the `realization.detailed_lines` expand.
        - union: A detailed (child) line type of a charge realization run. This is distinct from an invoice's own detailed lines: it represents the rated/priced breakdown produced by the realization run itself, before that breakdown is (or is not yet) reflected on an invoice line. Credit-then-invoice runs include credit allocations in these lines, while credits-only runs keep the gross rated detail.
          - object: A detailed line produced by a flat fee charge's realization run.
            - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
            - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
            - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
            - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
            - `type` 'flat_fee', required: The type of the charge the realization belongs to.
            - `service_period` object, required: The service period covered by this detailed line.
              - …
            - `totals` object, required: Aggregated financial totals for the detailed line.
              - …
            - `category` 'regular' | 'commitment', required: The cost category of this detailed line.
            - `credits_applied` BillingChargeRealizationDetailedLineCreditApplied[]: Credits applied to this detailed line.
              - …
            - `unit_price` string, required: The unit price of the detailed line.
            - `amount_discounts` BillingChargeRealizationAmountDiscount[], required: The amount discounts applied to the detailed line.
              - …
          - object: A detailed line produced by a usage-based charge's realization run.
            - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
            - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
            - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
            - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
            - `type` 'usage_based', required: The type of the charge the realization belongs to.
            - `service_period` object, required: The service period covered by this detailed line.
              - …
            - `totals` object, required: Aggregated financial totals for the detailed line.
              - …
            - `category` 'regular' | 'commitment', required: The cost category of this detailed line.
            - `credits_applied` BillingChargeRealizationDetailedLineCreditApplied[]: Credits applied to this detailed line.
              - …
            - `unit_price` string, required: The unit price of the detailed line.
            - `amount_discounts` BillingChargeRealizationAmountDiscount[], required: The amount discounts applied to the detailed line.
              - …
            - `quantity` string, required: The quantity of the detailed line.
            - `corrects_run_id` string: The ID of a prior realization run this detailed line corrects. Only set if the detailed line's totals are negative.
    - `payment_term` 'in_advance' | 'in_arrears', required: Payment term of the flat fee charge.
    - `discounts` object: The discounts applied to the charge.
      - `percentage` number: Percentage discount applied to the price (0–100).
    - `feature` union: The feature associated with the charge, when applicable.
      - Feature: A capability or billable dimension offered by a provider.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
        - `name` string, required: Display name of the resource. Between 1 and 256 characters.
        - `description` string: Optional description of the resource. Maximum 1024 characters.
        - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
        - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
        - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
        - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
        - `key` string, required: A key is a unique string that is used to identify a resource.
        - `meter` object: The meter that the feature is associated with and based on which usage is calculated. If not specified, the feature is static.
          - `id` string, required: The ID of the meter to associate with this feature.
          - `filters` object: Filters to apply to the dimensions of the meter.
        - `unit_cost` union: Optional per-unit cost configuration. Use "manual" for a fixed per-unit cost, or "llm" to look up cost from the LLM cost database based on meter group-by properties.
          - object: A fixed per-unit cost amount.
            - `type` 'manual', required: The type discriminator for manual unit cost.
            - `amount` string, required: Fixed per-unit cost amount in USD.
          - object: LLM cost lookup configuration. Each dimension (provider, model, token type) can be specified as either a static value or a meter group-by property name (mutually exclusive).
            - `type` 'llm', required: The type discriminator for LLM unit cost.
            - `provider_property` string: Meter group-by property that holds the LLM provider. Use this when the meter has a group-by dimension for provider. Mutually exclusive with `provider`.
            - `provider` string: Static LLM provider value (e.g., "openai", "anthropic"). Use this when the feature tracks a single provider. Mutually exclusive with `provider_property`.
            - `model_property` string: Meter group-by property that holds the model ID. Use this when the meter has a group-by dimension for model. Mutually exclusive with `model`.
            - `model` string: Static model ID value (e.g., "gpt-4", "claude-3-5-sonnet"). Use this when the feature tracks a single model. Mutually exclusive with `model_property`.
            - `token_type_property` string: Meter group-by property that holds the token type. Use this when the meter has a group-by dimension for token type. Mutually exclusive with `token_type`.
            - `token_type` 'input' | 'output' | 'cache_read' | 'cache_write' | 'reasoning' | 'request' | 'response': Static token type value. Use this when the feature tracks a single token type (e.g., only input tokens). `request` is an alias for `input`, `response` is an alias for `output`. Mutually exclusive with `token_type_property`.
            - `pricing` object: Resolved per-token pricing from the LLM cost database. Populated in responses when the provider and model can be determined, either from static values or from meter group-by filters with exact matches.
              - …
      - FeatureReference: Feature reference.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `proration_configuration` object, required: The proration configuration of the charge.
      - `mode` 'no_proration' | 'prorate_prices', required: The proration mode of the rate card.
    - `amount_after_proration` object, required: The amount after proration of the charge.
      - `amount` string, required: The amount as an arbitrary-precision decimal string.
      - `currency` union, required: The fiat or custom currency code of the amount.
        - string: Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. Custom three-letter currency codes are also supported for convenience.
        - string: Custom currency code. It should be a unique code but not conflicting with any existing fiat currency codes.
    - `price` object, required: The price of the charge.
      - `type` 'flat', required: The type of the price.
      - `amount` string, required: The amount of the flat price.
    - `system_intent` object: Current intent from the system lifecycle controller for a charge that has an active manual override. The top-level charge fields remain the effective customer-facing intent.
      - `name` string, required: Display name of the resource. Between 1 and 256 characters.
      - `description` string: Optional description of the resource. Maximum 1024 characters.
      - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
      - `invoice_at` string, date-time, required: The timestamp when the charge is intended to be invoiced.
      - `service_period` object, required: The effective service period covered by the charge.
        - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
        - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
      - `full_service_period` object, required: The full, unprorated service period of the charge.
        - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
        - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
      - `billing_period` object, required: The billing period the charge belongs to.
        - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
        - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
      - `payment_term` 'in_advance' | 'in_arrears', required: Payment term of the flat fee charge.
      - `discounts` object: The discounts applied to the charge.
        - `percentage` number: Percentage discount applied to the price (0–100).
      - `proration_configuration` object, required: The proration configuration of the charge.
        - `mode` 'no_proration' | 'prorate_prices', required: The proration mode of the rate card.
      - `amount_before_proration` object, required: The amount before proration of the system lifecycle controller flat fee intent.
        - `amount` string, required: The amount as an arbitrary-precision decimal string.
        - `currency` union, required: The fiat or custom currency code of the amount.
          - string: Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. Custom three-letter currency codes are also supported for convenience.
          - string: Custom currency code. It should be a unique code but not conflicting with any existing fiat currency codes.
      - `deleted_at` string, date-time: The timestamp when the system lifecycle controller intent was deleted. The effective charge can remain visible while a manual override is active.
  - object: A usage-based charge for a customer.
    - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `name` string, required: Display name of the resource. Between 1 and 256 characters.
    - `description` string: Optional description of the resource. Maximum 1024 characters.
    - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
    - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
    - `type` 'usage_based', required: The type of the charge.
    - `customer` union, required: The customer owning the charge. By default, only the `id` of the customer is returned. For more details use the `customer` expand.
      - BillingCustomer: Customers can be individuals or organizations that can subscribe to plans and have access to features.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
        - `name` string, required: Display name of the resource. Between 1 and 256 characters.
        - `description` string: Optional description of the resource. Maximum 1024 characters.
        - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
        - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
        - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
        - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
        - `key` string, required: ExternalResourceKey is a unique string that is used to identify a resource in an external system.
        - `usage_attribution` object: Mapping to attribute metered usage to the customer by the event subject.
          - `subject_keys` UsageAttributionSubjectKey[], required: The subjects that are attributed to the customer. Can be empty when no usage event subjects are associated with the customer.
        - `primary_email` string: The primary email address of the customer.
        - `currency` string: Currency of the customer. Used for billing, tax and invoicing.
        - `billing_address` object: The billing address of the customer. Used for tax and invoicing.
          - `country` string: Country code in [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html) alpha-2 format.
          - `postal_code` string: Postal code.
          - `state` string: State or province.
          - `city` string: City.
          - `line1` string: First line of the address.
          - `line2` string: Second line of the address.
          - `phone_number` string: Phone number.
      - CustomerReference: Customer reference.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `lifecycle_controller` 'system' | 'manual', required: Indicates whether the charge lifecycle is controlled by the system or manually overridden by the API user.
    - `subscription` union: The subscription that originated the charge, when the charge was created from a subscription item. By default, only the `id`, `phase.id`, `phase.item.id` of the subscription is returned. For more details use the `subscription` expand.
      - BillingSubscription: Subscription.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
        - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
        - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
        - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
        - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
        - `name` string, required: Display name of the subscription. Defaults to the plan name when the subscription is created from a plan.
        - `description` string: Optional description of the subscription.
        - `active_from` string, date-time, required: An ISO-8601 timestamp representation of when the subscription became (or will become) active.
        - `active_to` string, date-time: An ISO-8601 timestamp representation of when the subscription stops being active. Open-ended when not set.
        - `customer_id` string, required: The customer ID of the subscription.
        - `plan_id` string: The plan ID of the subscription. Set if subscription is created from a plan.
        - `plan` object: The plan the subscription was created from, if any. Includes the plan key and version so clients can resolve the exact plan revision.
          - `id` string, required: The plan ID (exact revision).
          - `key` string, required: The plan key. References the plan across versions.
          - `version` integer, required: The plan version.
        - `invoice_currency` string, required: The fiat currency in which the subscription is invoiced.
        - `cost_basis_mode` 'dynamic' | 'pinned', required: Controls whether custom-currency cost bases are resolved dynamically or pinned when their currency pair is introduced to the subscription.
        - `cost_basis_pins` BillingSubscriptionCostBasisPin[], required: Cost bases pinned to custom-currency pairs for this subscription.
          - `custom_currency_id` string, required: The managed custom currency ID.
          - `invoice_currency` string, required: The fiat currency in which the subscription is invoiced.
          - `cost_basis_id` string, required: The pinned cost basis resource ID.
        - `billing_cadence` string, ISO8601, required: The billing cadence of the subscription in ISO-8601 duration format. Defines how often the customer is billed. Examples: `P1M` (monthly), `P3M` (quarterly), `P1Y` (annually).
        - `pro_rating_config` object: The pro-rating configuration of the subscription.
          - `enabled` boolean, required: Whether pro-rating is enabled.
          - `mode` 'no_proration' | 'prorate_prices', required: How pro-rating is calculated when enabled.
        - `billing_anchor` string, date-time, required: A billing anchor is the fixed point in time that determines the subscription's recurring billing cycle. It affects when charges occur and how prorations are calculated. Common anchors: - Calendar month (1st of each month): `2025-01-01T00:00:00Z` - Subscription anniversary (day customer signed up) - Custom date (customer-specified day)
        - `status` 'active' | 'inactive' | 'canceled' | 'scheduled', required: The status of the subscription.
        - `settlement_mode` 'credit_then_invoice' | 'credit_only': Settlement mode for billing. Values: - `credit_then_invoice`: Credits are applied first, then any remainder is invoiced. - `credit_only`: Usage is settled exclusively against credits.
        - `current_period` object: The current aligned billing period. Present only when the subscription is active and aligned.
          - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
          - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
        - `phases` BillingSubscriptionPhase[], required: The phases of the subscription in chronological order. A phase groups the rate cards that are in effect for a segment of the subscription's lifetime.
          - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
          - `name` string, required: Display name of the resource. Between 1 and 256 characters.
          - `description` string: Optional description of the resource. Maximum 1024 characters.
          - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
          - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
          - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
          - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
          - `key` string, required: A key is a unique string that is used to identify a resource.
          - `active_from` string, date-time, required: An ISO-8601 timestamp representation of when the phase becomes active.
          - `active_to` string, date-time: An ISO-8601 timestamp representation of when the phase stops being active. Open-ended for the last phase.
          - `items` BillingSubscriptionItem[], required: The rate cards in effect for this phase, resolved to the version active at the queried time (the currently active version for the current phase, the first version for future phases, and the last version for past phases).
            - `id` string, required: The unique identifier of the subscription item instance.
            - `active_from` string, date-time, required: An ISO-8601 timestamp representation of when this item version becomes active.
            - `active_to` string, date-time: An ISO-8601 timestamp representation of when this item version stops being active.
            - `rate_card` object, required: The rate card describing what the customer gets and pays for this item.
              - …
      - BillingSubscriptionReference: Subscription reference represents a reference to the specific subscription item this entity represents.
        - `id` string, required: The ID of the subscription.
        - `name` string: The display name of the subscription. Only populated where the referencing endpoint documents a `subscription` expand that resolves it.
        - `phase` object, required: The phase of the subscription.
          - `id` string, required: The ID of the phase.
          - `item` object, required: The item of the phase.
            - `id` string, required: The ID of the item.
    - `currency` union, required: The currency of the charge.
      - string: Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. Custom three-letter currency codes are also supported for convenience.
      - string: Custom currency code. It should be a unique code but not conflicting with any existing fiat currency codes.
    - `resolved_cost_basis` object: The resolved fiat conversion rate of a custom-currency charge. Resolution depends on costbasis type: dynamic is resolved when charge becomes active, all other types resolved on creation.
      - `fiat_currency` string, required: The fiat currency the charge amount is converted into for invoicing.
      - `rate` string, required: Fiat amount per one unit of the custom currency.
      - `cost_basis_id` string: ID of the custom currency's cost basis resource the rate was taken from. Absent for manual cost bases.
      - `resolved_at` string, date-time, required: When the rate was resolved.
    - `status` 'created' | 'active' | 'final' | 'deleted', required: The lifecycle status of the charge.
    - `validation_issues` BillingValidationIssue[]: Validation issues found while processing the charge. Present only when there are one or more validation findings. An empty list is omitted.
      - `code` string, required: Machine-readable error code.
      - `message` string, required: Human-readable description of the error.
      - `attributes` object: Additional structured context.
      - `severity` 'critical' | 'warning', required: Severity of the validation issue.
      - `field` string: JSON path to the field that caused the validation issue, if applicable.
      - `component` string: Component that reported the validation issue, if applicable.
    - `invoice_at` string, date-time, required: The timestamp when the charge is intended to be invoiced.
    - `service_period` object, required: The effective service period covered by the charge.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
    - `full_service_period` object, required: The full, unprorated service period of the charge.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
    - `billing_period` object, required: The billing period the charge belongs to.
      - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
      - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
    - `advance_after` string, date-time: The earliest time when the charge should be advanced again by background processing.
    - `unique_reference_id` string: Unique reference ID of the charge.
    - `settlement_mode` 'credit_then_invoice' | 'credit_only', required: Settlement mode of the charge.
    - `tax_config` object: Tax configuration of the charge.
      - `behavior` 'inclusive' | 'exclusive': Tax behavior. If not specified the billing profile is used to determine the tax behavior. If not specified in the billing profile, the provider's default behavior is used.
      - `stripe` object: Stripe tax config.
        - `code` string, required: Product [tax code](https://docs.stripe.com/tax/tax-codes).
      - `external_invoicing` object: External invoicing tax config.
        - `code` string, required: The tax code should be interpreted by the external invoicing provider.
      - `tax_code_id` string: Tax code ID.
      - `tax_code` object: Tax code reference. When both `tax_code` and `tax_code_id` are provided, `tax_code` takes precedence. When `stripe.code` is also provided, `tax_code` still wins and `stripe.code` is ignored.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `realizations` BillingChargeRealization[], required: The realization runs of the charge, sorted by `created_at`.
      - `id` string: The ID of the realization run. Not present on `outstanding` entries, which are projections rather than persisted runs.
      - `line_id` string: The ID of the invoice line this realization was booked to, when the realization has been invoiced.
      - `invoice` union: The reference of the invoice related to the realization.
        - BillingChargeRealizationInvoice: The invoice a charge realization was booked to, embedded as a header. Matches the standard invoice entity, except that it carries no `customer` snapshot (the charge context already identifies the customer) and `lines` are never populated (the realization itself is the line-level breakdown). The shared invoice contract stays untouched: this model exists so the charges API can slim the embedding without loosening the invoices API.
          - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
          - `description` string: Optional description of the resource. Maximum 1024 characters.
          - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
          - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
          - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
          - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
          - `number` string, required: Human-readable invoice number generated by the invoicing app.
          - `currency` string, required: Three-letter ISO 4217 currency code for the invoice.
          - `supplier` object, required: Snapshot of the supplier's contact information at the time the invoice was issued.
            - `name` string: Legal name or representation of the party.
            - `tax_id` object: The entity's legal identification used for tax purposes. They may have other numbers, but we're only interested in those valid for tax purposes.
              - …
            - `addresses` object: Address for where information should be sent if needed.
              - …
            - `id` string: Unique identifier for the party.
          - `totals` object, required: Aggregated financial totals for the invoice.
            - `amount` string, required: The total value of the resource before taxes, discounts and commitments.
            - `taxes_total` string, required: The total tax amount applied to the resource.
            - `taxes_inclusive_total` string, required: The total tax amount already included in the resource amount.
            - `taxes_exclusive_total` string, required: The total tax amount added on top of the resource amount.
            - `charges_total` string, required: The total amount contributed by additional charges.
            - `discounts_total` string, required: The total amount deducted through discounts.
            - `credits_total` string, required: The total amount deducted through credits before taxes are applied.
            - `total` string, required: The final total value of the resource after taxes, discounts and commitments.
          - `service_period` object, required: The service period covered by this invoice. For flat fee the service period can be empty which means `from` will be equals to `to`. In other cases those fields will be filled with the actual service period.
            - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
            - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
          - `validation_issues` BillingValidationIssue[]: Validation issues found during invoice processing. Present only when there are one or more validation findings. An empty list is omitted.
            - `code` string, required: Machine-readable error code.
            - `message` string, required: Human-readable description of the error.
            - `attributes` object: Additional structured context.
            - `severity` 'critical' | 'warning', required: Severity of the validation issue.
            - `field` string: JSON path to the field that caused the validation issue, if applicable.
            - `component` string: Component that reported the validation issue, if applicable.
          - `external_references` object: External identifiers assigned to this invoice by third-party systems.
            - `invoicing_id` string: The ID assigned by the external invoicing app (e.g. Stripe invoice ID).
            - `payment_id` string: The ID assigned by the external payment app (e.g. Stripe payment intent ID).
          - `type` 'standard', required: Discriminator field identifying this as a standard invoice.
          - `status` 'draft' | 'issuing' | 'issued' | 'payment_processing' | 'overdue' | 'paid' | 'uncollectible' | 'voided', required: Current lifecycle status of the invoice.
          - `status_details` object, required: Detailed status information including available actions and workflow state.
            - `immutable` boolean, required: Whether the invoice is immutable (i.e. cannot be modified or deleted).
            - `failed` boolean, required: Whether the invoice is in a failed state.
            - `extended_status` string, required: Fine-grained internal status string providing additional workflow detail beyond the top-level status enum.
            - `available_actions` object, required: The set of state-transition actions currently available for this invoice.
              - …
          - `issued_at` string, date-time: Timestamp when the invoice was issued to the customer.
          - `draft_until` string, date-time: Timestamp until which the invoice remains in draft state. The invoice advances automatically once this time is reached.
          - `quantity_snapshotted_at` string, date-time: Timestamp when usage quantities were last snapshotted for this invoice.
          - `collection_at` string, date-time: Timestamp when collection was initiated for this invoice.
          - `due_at` string, date-time: Timestamp when payment is due.
          - `sent_to_customer_at` string, date-time: Timestamp when the invoice was sent to the customer.
          - `workflow` object, required: Workflow configuration snapshot captured at invoice creation time.
            - `apps` object: The apps that will be used to orchestrate the invoice's workflow.
              - …
            - `source_billing_profile` object, required: The billing profile that was the source of this workflow snapshot.
              - …
            - `workflow` object, required: The workflow configuration that was active when the invoice was created. Only the fields that are meaningful at the per-invoice level are included: invoicing behaviour (auto-advance, draft period) and payment settings (collection method, due date). Profile-wide settings such as collection alignment, progressive billing, and tax policy are omitted.
              - …
        - ChargeRealizationInvoiceReference: ChargeRealizationInvoice reference.
          - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
      - `type` 'final_realization' | 'partial_invoice' | 'outstanding' | 'voided', required: The type of the realization run.
      - `service_period` object, required: The service period covered by this realization run.
        - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
        - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
      - `usage` string: The metered usage quantity this realization run accounts for. Only present on usage-based charges; flat fees are not metered, so their realizations carry no usage. Booked entries report a signed delta: a negative value states a downward usage correction (or a voided run that snapshotted behind its live neighbors) instead of masking it as zero. On an `outstanding` entry this is `0` unless the `real_time_usage` expand is applied, in which case it is the not-yet-booked remainder of the live metering read (never negative).
      - `payment` object: The payment state of the realization, when the charge requires a fiat transaction to settle.
        - `status` 'authorized' | 'settled', required: The settlement status of the payment.
      - `totals` object: Financial totals for the realization run, including credit allocations. Requires the `realization.totals` expand.
        - `amount` string, required: The total value of the resource before taxes, discounts and commitments.
        - `taxes_total` string, required: The total tax amount applied to the resource.
        - `taxes_inclusive_total` string, required: The total tax amount already included in the resource amount.
        - `taxes_exclusive_total` string, required: The total tax amount added on top of the resource amount.
        - `charges_total` string, required: The total amount contributed by additional charges.
        - `discounts_total` string, required: The total amount deducted through discounts.
        - `credits_total` string, required: The total amount deducted through credits before taxes are applied.
        - `total` string, required: The final total value of the resource after taxes, discounts and commitments.
      - `detailed_lines` BillingChargeRealizationDetailedLine[]: The detailed (rated) lines produced by the realization run. Requires the `realization.detailed_lines` expand.
        - union: A detailed (child) line type of a charge realization run. This is distinct from an invoice's own detailed lines: it represents the rated/priced breakdown produced by the realization run itself, before that breakdown is (or is not yet) reflected on an invoice line. Credit-then-invoice runs include credit allocations in these lines, while credits-only runs keep the gross rated detail.
          - object: A detailed line produced by a flat fee charge's realization run.
            - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
            - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
            - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
            - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
            - `type` 'flat_fee', required: The type of the charge the realization belongs to.
            - `service_period` object, required: The service period covered by this detailed line.
              - …
            - `totals` object, required: Aggregated financial totals for the detailed line.
              - …
            - `category` 'regular' | 'commitment', required: The cost category of this detailed line.
            - `credits_applied` BillingChargeRealizationDetailedLineCreditApplied[]: Credits applied to this detailed line.
              - …
            - `unit_price` string, required: The unit price of the detailed line.
            - `amount_discounts` BillingChargeRealizationAmountDiscount[], required: The amount discounts applied to the detailed line.
              - …
          - object: A detailed line produced by a usage-based charge's realization run.
            - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
            - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
            - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
            - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
            - `type` 'usage_based', required: The type of the charge the realization belongs to.
            - `service_period` object, required: The service period covered by this detailed line.
              - …
            - `totals` object, required: Aggregated financial totals for the detailed line.
              - …
            - `category` 'regular' | 'commitment', required: The cost category of this detailed line.
            - `credits_applied` BillingChargeRealizationDetailedLineCreditApplied[]: Credits applied to this detailed line.
              - …
            - `unit_price` string, required: The unit price of the detailed line.
            - `amount_discounts` BillingChargeRealizationAmountDiscount[], required: The amount discounts applied to the detailed line.
              - …
            - `quantity` string, required: The quantity of the detailed line.
            - `corrects_run_id` string: The ID of a prior realization run this detailed line corrects. Only set if the detailed line's totals are negative.
    - `discounts` object: Discounts applied to the usage-based charge.
      - `percentage` number: Percentage discount applied to the price (0–100).
      - `usage` string: Number of usage units granted free before billing starts. Only applies to usage-based lines (not flat fees). Usage is treated as zero until this amount is exhausted.
    - `feature` union, required: The feature associated with the charge.
      - Feature: A capability or billable dimension offered by a provider.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
        - `name` string, required: Display name of the resource. Between 1 and 256 characters.
        - `description` string: Optional description of the resource. Maximum 1024 characters.
        - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
        - `created_at` string, date-time, required: An ISO-8601 timestamp representation of entity creation date.
        - `updated_at` string, date-time, required: An ISO-8601 timestamp representation of entity last update date.
        - `deleted_at` string, date-time: An ISO-8601 timestamp representation of entity deletion date.
        - `key` string, required: A key is a unique string that is used to identify a resource.
        - `meter` object: The meter that the feature is associated with and based on which usage is calculated. If not specified, the feature is static.
          - `id` string, required: The ID of the meter to associate with this feature.
          - `filters` object: Filters to apply to the dimensions of the meter.
        - `unit_cost` union: Optional per-unit cost configuration. Use "manual" for a fixed per-unit cost, or "llm" to look up cost from the LLM cost database based on meter group-by properties.
          - object: A fixed per-unit cost amount.
            - `type` 'manual', required: The type discriminator for manual unit cost.
            - `amount` string, required: Fixed per-unit cost amount in USD.
          - object: LLM cost lookup configuration. Each dimension (provider, model, token type) can be specified as either a static value or a meter group-by property name (mutually exclusive).
            - `type` 'llm', required: The type discriminator for LLM unit cost.
            - `provider_property` string: Meter group-by property that holds the LLM provider. Use this when the meter has a group-by dimension for provider. Mutually exclusive with `provider`.
            - `provider` string: Static LLM provider value (e.g., "openai", "anthropic"). Use this when the feature tracks a single provider. Mutually exclusive with `provider_property`.
            - `model_property` string: Meter group-by property that holds the model ID. Use this when the meter has a group-by dimension for model. Mutually exclusive with `model`.
            - `model` string: Static model ID value (e.g., "gpt-4", "claude-3-5-sonnet"). Use this when the feature tracks a single model. Mutually exclusive with `model_property`.
            - `token_type_property` string: Meter group-by property that holds the token type. Use this when the meter has a group-by dimension for token type. Mutually exclusive with `token_type`.
            - `token_type` 'input' | 'output' | 'cache_read' | 'cache_write' | 'reasoning' | 'request' | 'response': Static token type value. Use this when the feature tracks a single token type (e.g., only input tokens). `request` is an alias for `input`, `response` is an alias for `output`. Mutually exclusive with `token_type_property`.
            - `pricing` object: Resolved per-token pricing from the LLM cost database. Populated in responses when the provider and model can be determined, either from static values or from meter group-by filters with exact matches.
              - …
      - FeatureReference: Feature reference.
        - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
    - `totals` object, required: Aggregated booked and realtime totals for the charge.
      - `booked` object, required: The amount of the charge already booked to the internal accounting system.
        - `amount` string, required: The total value of the resource before taxes, discounts and commitments.
        - `taxes_total` string, required: The total tax amount applied to the resource.
        - `taxes_inclusive_total` string, required: The total tax amount already included in the resource amount.
        - `taxes_exclusive_total` string, required: The total tax amount added on top of the resource amount.
        - `charges_total` string, required: The total amount contributed by additional charges.
        - `discounts_total` string, required: The total amount deducted through discounts.
        - `credits_total` string, required: The total amount deducted through credits before taxes are applied.
        - `total` string, required: The final total value of the resource after taxes, discounts and commitments.
      - `realtime` object: The realtime amount of the charge, i.e. the whole usage rated at the charge's price for its full service period, ignoring what has already been booked to a realization. This differs from the `usage` of a realization with type `outstanding`, which only covers the quantity not yet booked. Requires the `real_time_usage` expand.
        - `amount` string, required: The total value of the resource before taxes, discounts and commitments.
        - `taxes_total` string, required: The total tax amount applied to the resource.
        - `taxes_inclusive_total` string, required: The total tax amount already included in the resource amount.
        - `taxes_exclusive_total` string, required: The total tax amount added on top of the resource amount.
        - `charges_total` string, required: The total amount contributed by additional charges.
        - `discounts_total` string, required: The total amount deducted through discounts.
        - `credits_total` string, required: The total amount deducted through credits before taxes are applied.
        - `total` string, required: The final total value of the resource after taxes, discounts and commitments.
    - `usage` string: The metered usage quantity of the charge for its full service period. Requires the `real_time_usage` expand, since it is computed live from the metering store rather than stored on the charge.
    - `price` union, required: The price of the charge. `free` prices are rejected on create: a usage-based charge always carries a concrete price.
      - object: Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the object, billing units are the converted quantities (e.g. GB instead of bytes).
        - `type` 'unit', required: The type of the price.
        - `amount` string, required: The amount of the unit price.
      - object: Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.
        - `type` 'graduated', required: The type of the price.
        - `tiers` BillingPriceTier[], required: The tiers of the graduated price. At least one tier is required.
          - `up_to_amount` string: Up to and including this quantity will be contained in the tier. If undefined, the tier is open-ended (the last tier).
          - `flat_price` object: The flat price component of the tier. Charged once when the tier is entered.
            - `type` 'flat', required: The type of the price.
            - `amount` string, required: The amount of the flat price.
          - `unit_price` object: The unit price component of the tier. Charged per billing unit within the tier.
            - `type` 'unit', required: The type of the price.
            - `amount` string, required: The amount of the unit price.
      - object: Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.
        - `type` 'volume', required: The type of the price.
        - `tiers` BillingPriceTier[], required: The tiers of the volume price. At least one tier is required.
          - `up_to_amount` string: Up to and including this quantity will be contained in the tier. If undefined, the tier is open-ended (the last tier).
          - `flat_price` object: The flat price component of the tier. Charged once when the tier is entered.
            - `type` 'flat', required: The type of the price.
            - `amount` string, required: The amount of the flat price.
          - `unit_price` object: The unit price component of the tier. Charged per billing unit within the tier.
            - `type` 'unit', required: The type of the price.
            - `amount` string, required: The amount of the unit price.
    - `commitments` object: Spend commitments for the charge.
      - `minimum_amount` string: The customer is committed to spend at least the amount.
      - `maximum_amount` string: The customer is limited to spend at most the amount.
    - `unit_config` object: Unit conversion configuration for the charge. Synthesized on read for charges created from v1 dynamic or package prices: dynamic prices map to a unit price with a multiply unit config, and package prices map to a unit price with a divide unit config. Accepted on create only when the UnitConfig feature is enabled on the deployment; otherwise rejected.
      - `operation` 'divide' | 'multiply', required: The arithmetic operation to apply to the raw metered quantity.
      - `conversion_factor` string, required: The factor used in the conversion operation. - For `divide`: `converted = raw / conversionFactor`. - For `multiply`: `converted = raw × conversionFactor`. Must be a positive non-zero value.
      - `rounding` 'ceiling' | 'floor' | 'half_up' | 'none': The rounding mode applied to the converted quantity for invoicing. Defaults to none (no rounding). Entitlement checks always use the precise (unrounded) value.
      - `precision` integer: The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers).
      - `display_unit` string: A human-readable label for the converted unit shown on invoices and in the customer portal (e.g., "GB", "hours", "M tokens"). Optional. When omitted, no unit label is rendered.
    - `system_intent` object: Current intent from the system lifecycle controller for a charge that has an active manual override. The top-level charge fields remain the effective customer-facing intent.
      - `name` string, required: Display name of the resource. Between 1 and 256 characters.
      - `description` string: Optional description of the resource. Maximum 1024 characters.
      - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
      - `invoice_at` string, date-time, required: The timestamp when the charge is intended to be invoiced.
      - `service_period` object, required: The effective service period covered by the charge.
        - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
        - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
      - `full_service_period` object, required: The full, unprorated service period of the charge.
        - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
        - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
      - `billing_period` object, required: The billing period the charge belongs to.
        - `from` string, date-time, required: The start of the period. The period is inclusive at the start.
        - `to` string, date-time, required: The end of the period. The period is exclusive at the end.
      - `discounts` object: Discounts applied to the usage-based charge.
        - `percentage` number: Percentage discount applied to the price (0–100).
        - `usage` string: Number of usage units granted free before billing starts. Only applies to usage-based lines (not flat fees). Usage is treated as zero until this amount is exhausted.
      - `price` union, required: The price of the charge. `free` prices are rejected on create: a usage-based charge always carries a concrete price.
        - object: Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the object, billing units are the converted quantities (e.g. GB instead of bytes).
          - `type` 'unit', required: The type of the price.
          - `amount` string, required: The amount of the unit price.
        - object: Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.
          - `type` 'graduated', required: The type of the price.
          - `tiers` BillingPriceTier[], required: The tiers of the graduated price. At least one tier is required.
            - `up_to_amount` string: Up to and including this quantity will be contained in the tier. If undefined, the tier is open-ended (the last tier).
            - `flat_price` object: The flat price component of the tier. Charged once when the tier is entered.
              - …
            - `unit_price` object: The unit price component of the tier. Charged per billing unit within the tier.
              - …
        - object: Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.
          - `type` 'volume', required: The type of the price.
          - `tiers` BillingPriceTier[], required: The tiers of the volume price. At least one tier is required.
            - `up_to_amount` string: Up to and including this quantity will be contained in the tier. If undefined, the tier is open-ended (the last tier).
            - `flat_price` object: The flat price component of the tier. Charged once when the tier is entered.
              - …
            - `unit_price` object: The unit price component of the tier. Charged per billing unit within the tier.
              - …
      - `commitments` object: Spend commitments for the charge.
        - `minimum_amount` string: The customer is committed to spend at least the amount.
        - `maximum_amount` string: The customer is limited to spend at most the amount.
      - `unit_config` object: Unit conversion configuration for the charge. Synthesized on read for charges created from v1 dynamic or package prices: dynamic prices map to a unit price with a multiply unit config, and package prices map to a unit price with a divide unit config. Accepted on create only when the UnitConfig feature is enabled on the deployment; otherwise rejected.
        - `operation` 'divide' | 'multiply', required: The arithmetic operation to apply to the raw metered quantity.
        - `conversion_factor` string, required: The factor used in the conversion operation. - For `divide`: `converted = raw / conversionFactor`. - For `multiply`: `converted = raw × conversionFactor`. Must be a positive non-zero value.
        - `rounding` 'ceiling' | 'floor' | 'half_up' | 'none': The rounding mode applied to the converted quantity for invoicing. Defaults to none (no rounding). Entitlement checks always use the precise (unrounded) value.
        - `precision` integer: The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers).
        - `display_unit` string: A human-readable label for the converted unit shown on invoices and in the customer portal (e.g., "GB", "hours", "M tokens"). Optional. When omitted, no unit label is rendered.
      - `deleted_at` string, date-time: The timestamp when the system lifecycle controller intent was deleted. The effective charge can remain visible while a manual override is active.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
  - added `#/components/schemas/InvalidParameterMinimumTime, #/components/schemas/InvalidParameterMaximumTime` to the `invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `key_invalid` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new `unique` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2026-10-07** `59663dd13a10`: 1 info
  - endpoint added
- **2026-09-18** `f324fb7610e4`: 1 breaking
  - api path removed without deprecation
- **2026-07-16** `a2e95e9f6c80`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/openmeter/customers/:customerId/charges/post.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/7aab863a6daa?raw)