--- title: "List billing invoices" method: GET path: "/openmeter/billing/invoices" tags: ["OpenMeter Billing Settings"] --- # List billing invoices `GET /openmeter/billing/invoices` List billing invoices. Returns a page of invoices. Gathering invoices are never included. Use `filter` to narrow by status, customer, dates, or service period start. Use `sort` to control ordering. ## Query parameters - `page` object - `size` integer — The number of items to include per page. - `number` integer — The page number. - `sort` string — The `asc` suffix is optional as the default sort order is ascending. The `desc` suffix is used to specify a descending order. Multiple sort attributes may be provided via a comma separated list. JSONPath notation may be used to specify a sub-attribute (eg: 'foo.bar desc'). - `filter` ListInvoicesParamsFilter — Filter options for listing invoices. - `status` union — Filters on the given string field value by exact match. All properties are optional; provide exactly one to specify the comparison. - string - object - `eq` string — Value strictly equals the given string value. - `oeq` string — Returns entities that exact match any of the comma-delimited phrases in the filter string. - `neq` string — Value does not equal the given string value. - `customer_id` union — Filters on the given ULID field value by exact match. All properties are optional; provide exactly one to specify the comparison. - string — ULID (Universally Unique Lexicographically Sortable Identifier). - object - `eq` string — ULID (Universally Unique Lexicographically Sortable Identifier). - `oeq` string — Returns entities that exact match any of the comma-delimited ULIDs in the filter string. - `neq` string — ULID (Universally Unique Lexicographically Sortable Identifier). - `issued_at` union — Filters on the given datetime (RFC-3339) field value. All properties are optional; provide exactly one to specify the comparison. - string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - object - `eq` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `lt` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `lte` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `gt` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `gte` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `service_period_start` union — Filters on the given datetime (RFC-3339) field value. All properties are optional; provide exactly one to specify the comparison. - string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - object - `eq` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `lt` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `lte` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `gt` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `gte` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `created_at` union — Filters on the given datetime (RFC-3339) field value. All properties are optional; provide exactly one to specify the comparison. - string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - object - `eq` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `lt` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `lte` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `gt` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `gte` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. ## Response `200` Page paginated response. - InvoicePagePaginatedResponse — Page paginated response. - `data` BillingInvoice[], required - `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 — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `updated_at` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `deleted_at` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `number` string, required — InvoiceNumber is a unique identifier for the invoice, generated by the invoicing app. The uniqueness depends on a lot of factors: - app setting (unique per app or unique per customer) - multiple app scenarios (multiple apps generating invoices with the same prefix) - `currency` string, required — Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. Custom three-letter currency codes are also supported for convenience. - `supplier` BillingSupplier, required — Snapshot of the supplier's information at the time the invoice was issued. Structurally a read-only subset of `BillingParty` (the type configured on the billing profile), so the snapshot stays aligned with the source. `key` is omitted because it is not part of the snapshotted supplier data. - `name` string — Legal name or representation of the party. - `tax_id` BillingPartyTaxIdentity — Identity stores the details required to identify an entity for tax purposes in a specific country. - `code` string — Tax identifier code is a normalized tax code shown on the original identity document. - `addresses` BillingPartyAddresses — A collection of addresses for the party. - `billing_address` Address, required — Address - `country` string — [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html) alpha-2 country code. Custom two-letter country codes are also supported for convenience. - `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. - `id` string — Unique identifier for the party. - `customer` BillingInvoiceCustomer, required — Snapshot of the customer's information at the time the invoice was issued. - `name` string, required — Display name of the resource. Between 1 and 256 characters. - `usage_attribution` BillingCustomerUsageAttribution — Mapping to attribute metered usage to the customer. One customer can have zero or more subjects, but one subject can only belong to one customer. - `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. - `billing_address` Address — Address - `country` string — [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html) alpha-2 country code. Custom two-letter country codes are also supported for convenience. - `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. - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `key` string — ExternalResourceKey is a unique string that is used to identify a resource in an external system. - `totals` BillingTotals, required — Totals contains the summaries of all calculations for a billing resource. - `amount` string, required — Numeric represents an arbitrary precision number. - `taxes_total` string, required — Numeric represents an arbitrary precision number. - `taxes_inclusive_total` string, required — Numeric represents an arbitrary precision number. - `taxes_exclusive_total` string, required — Numeric represents an arbitrary precision number. - `charges_total` string, required — Numeric represents an arbitrary precision number. - `discounts_total` string, required — Numeric represents an arbitrary precision number. - `credits_total` string, required — Numeric represents an arbitrary precision number. - `total` string, required — Numeric represents an arbitrary precision number. - `service_period` ClosedPeriod, required — A period with defined start and end dates. The period is always inclusive at the start and exclusive at the end. - `from` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `to` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `validation_issues` BillingInvoiceValidationIssue[] — 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 level of an invoice validation issue. - `field` string — JSON path to the field that caused this validation issue, if applicable. For example: `lines/0/rate_card/price`. - `external_references` BillingInvoiceExternalReferences — External identifiers assigned to an 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 — Lifecycle status of a standard invoice. - `status_details` BillingInvoiceStatusDetails, required — Detailed status information for a standard invoice. - `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` BillingInvoiceAvailableActions, required — The set of state-transition actions available for an invoice in its current status. A field is present only when that action is permitted from the current state. - `advance` BillingInvoiceAvailableActionDetails — Details about an available invoice action including the resulting state. - `resulting_state` string, required — The extended status the invoice will transition to after performing this action. - `approve` BillingInvoiceAvailableActionDetails — Details about an available invoice action including the resulting state. - `resulting_state` string, required — The extended status the invoice will transition to after performing this action. - `delete` BillingInvoiceAvailableActionDetails — Details about an available invoice action including the resulting state. - `resulting_state` string, required — The extended status the invoice will transition to after performing this action. - `retry` BillingInvoiceAvailableActionDetails — Details about an available invoice action including the resulting state. - `resulting_state` string, required — The extended status the invoice will transition to after performing this action. - `snapshot_quantities` BillingInvoiceAvailableActionDetails — Details about an available invoice action including the resulting state. - `resulting_state` string, required — The extended status the invoice will transition to after performing this action. - `issued_at` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `draft_until` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `quantity_snapshotted_at` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `collection_at` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `due_at` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `sent_to_customer_at` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `workflow` BillingInvoiceWorkflowSettings, required — Snapshot of the billing workflow configuration captured at invoice creation. - `apps` BillingInvoiceWorkflowAppsReferences — BillingInvoiceWorkflowAppsReferences represents the references (id) to the apps used by a billing profile - `tax` BillingAppReference, required — App reference. - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `invoicing` BillingAppReference, required — App reference. - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `payment` BillingAppReference, required — App reference. - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `source_billing_profile` BillingProfileReference, required — Billing profile reference. - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `workflow` BillingInvoiceWorkflow, required — Invoice-level snapshot of the workflow configuration. Contains only the settings that are meaningful for an already-created invoice: invoicing behaviour and payment settings. Collection alignment and tax policy are gather-time / profile-wide concerns and are not included. - `invoicing` BillingInvoiceWorkflowInvoicingSettings — Invoice-level invoicing settings. A subset of BillingWorkflowInvoicingSettings limited to fields that are meaningful per-invoice. progressive_billing is omitted as it is a gather-time / profile-level decision. - `auto_advance` boolean — Whether to automatically issue the invoice after the draft_period has passed. - `draft_period` string, ISO8601 — The period for the invoice to be kept in draft status for manual reviews. - `due_after` string, ISO8601 — The period after which the invoice is considered overdue if not paid. - `payment` union — Payment settings for a billing workflow. - object — Payment settings for a billing workflow when the collection method is charge automatically. - `collection_method` 'charge_automatically', required — The collection method for the invoice. - object — Payment settings for a billing workflow when the collection method is send invoice. - `collection_method` 'send_invoice', required — The collection method for the invoice. - `due_after` string, ISO8601 — The period after which the invoice is due. With some payment solutions it's only applicable for manual collection method. - `lines` BillingInvoiceLine[] — Line items on this invoice. Always returned on single-resource GET; omitted on list endpoints unless explicitly expanded. Editable via update: existing lines are matched by `id`, lines without an `id` are created, and lines present on the invoice but omitted from the update request are deleted. Detailed (child) lines are always computed and cannot be edited directly. - `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 — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `updated_at` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `deleted_at` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `id` string — ULID (Universally Unique Lexicographically Sortable Identifier). - `type` 'standard_line', required — The type of charge this line item represents. - `lifecycle_controller` 'system' | 'manual', required — Identifies whether a resource lifecycle is controlled by OpenMeter or manually overridden by the API user. Values: - `system`: The resource lifecycle is controlled by OpenMeter. - `manual`: The resource lifecycle was manually overridden by the API user. - `service_period` ClosedPeriod, required — A period with defined start and end dates. The period is always inclusive at the start and exclusive at the end. - `from` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `to` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `totals` BillingTotals, required — Totals contains the summaries of all calculations for a billing resource. - `amount` string, required — Numeric represents an arbitrary precision number. - `taxes_total` string, required — Numeric represents an arbitrary precision number. - `taxes_inclusive_total` string, required — Numeric represents an arbitrary precision number. - `taxes_exclusive_total` string, required — Numeric represents an arbitrary precision number. - `charges_total` string, required — Numeric represents an arbitrary precision number. - `discounts_total` string, required — Numeric represents an arbitrary precision number. - `credits_total` string, required — Numeric represents an arbitrary precision number. - `total` string, required — Numeric represents an arbitrary precision number. - `discounts` BillingInvoiceLineDiscounts — Discounts applied to an invoice line item. - `amount` BillingInvoiceLineAmountDiscount[] — Monetary amount discounts (e.g. from maximum spend commitments). - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `reason` 'maximum_spend' | 'ratecard_percentage' | 'ratecard_usage', required — The reason a discount was applied to an invoice line. - `description` string — Optional human-readable description of the discount. - `external_references` BillingInvoiceLineExternalReferences — External identifiers for an invoice line item assigned by third-party systems. - `invoicing_id` string — The ID assigned by the external invoicing app. - `amount` string, required — Numeric represents an arbitrary precision number. - `usage` BillingInvoiceLineUsageDiscount[] — Usage quantity discounts (e.g. free tier usage allowances). - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `reason` 'maximum_spend' | 'ratecard_percentage' | 'ratecard_usage', required — The reason a discount was applied to an invoice line. - `description` string — Optional human-readable description of the discount. - `external_references` BillingInvoiceLineExternalReferences — External identifiers for an invoice line item assigned by third-party systems. - `invoicing_id` string — The ID assigned by the external invoicing app. - `quantity` string, required — Numeric represents an arbitrary precision number. - `credits_applied` BillingInvoiceLineCreditsApplied[] — Credit applied to this line item. - `amount` string, required — Numeric represents an arbitrary precision number. - `description` string — Optional human-readable description of the credit allocation. - `external_references` BillingInvoiceLineExternalReferences — External identifiers for an invoice line item assigned by third-party systems. - `invoicing_id` string — The ID assigned by the external invoicing app. - `subscription` BillingSubscriptionReference — Subscription reference represents a reference to the specific subscription item this entity represents. - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `phase` object, required — The phase of the subscription. - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `item` object, required — The item of the phase. - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `rate_card` BillingInvoiceLineRateCard, required — Rate card configuration snapshot for a usage-based invoice line. - `price` union, required — Price. - object — Free price. - `type` 'free', required — The type of the price. - object — Flat price. - `type` 'flat', required — The type of the price. - `amount` string, required — Numeric represents an arbitrary precision number. - object — Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the rate card, billing units are the converted quantities (e.g. GB instead of bytes). - `type` 'unit', required — The type of the price. - `amount` string, required — Numeric represents an arbitrary precision number. - 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 rate card, 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. - … - 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 rate card, 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. - … - `tax_config` BillingRateCardTaxConfig — The tax config of the rate card. - `behavior` 'inclusive' | 'exclusive' — Tax behavior. This enum is used to specify whether tax is included in the price or excluded from the price. - `code` TaxCodeReference, required — TaxCode reference. - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `feature_key` string — A key is a unique string that is used to identify a resource. - `discounts` BillingRateCardDiscounts — Discount configuration for a rate card. - `percentage` number — Percentage discount applied to the price (0–100). - `usage` string — Numeric represents an arbitrary precision number. - `unit_config` BillingUnitConfig — Unit conversion configuration. Transforms raw metered quantities into billing-ready units before pricing and entitlement evaluation. Applied at the rate card level so the same feature can be billed in different units across plans. Examples: - Meter bytes, bill GB: operation=divide, conversionFactor=1e9, rounding=ceiling, displayUnit="GB" - Meter seconds, bill hours: operation=divide, conversionFactor=3600, rounding=ceiling, displayUnit="hours" - Cost + 20% margin: operation=multiply, conversionFactor=1.2 - Bill per million tokens: operation=divide, conversionFactor=1e6, rounding=ceiling, displayUnit="M" v1 equivalents: - DynamicPrice(multiplier): operation=multiply, conversionFactor=multiplier + UnitPrice(amount=1) - PackagePrice(amount, quantityPerPkg): operation=divide, conversionFactor=quantityPerPkg, rounding=ceiling + UnitPrice(amount) - `operation` 'divide' | 'multiply', required — The arithmetic operation used to convert raw metered units into billing units. - `divide`: Divide the metered quantity by the conversion factor (e.g., bytes ÷ 1e9 = GB). - `multiply`: Multiply the metered quantity by the conversion factor (e.g., cost × 1.2 = cost + 20% margin). - `conversion_factor` string, required — Numeric represents an arbitrary precision number. - `rounding` 'ceiling' | 'floor' | 'half_up' | 'none' — The rounding mode applied to the converted quantity for invoicing. Rounding is applied only to the invoiced quantity. Entitlement balance checks use the precise decimal value after conversion. - `ceiling`: Round up to the next integer (typical for package-style billing). - `floor`: Round down to the previous integer. - `half_up`: Round to the nearest integer, with 0.5 rounding up. - `none`: No rounding; the converted value is used as-is. - `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. - `detailed_lines` BillingInvoiceDetailedLine[], required — Detailed sub-lines that this line has been broken down into. Present when line has individual details. - `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 — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `updated_at` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `deleted_at` string, date-time — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `service_period` ClosedPeriod, required — A period with defined start and end dates. The period is always inclusive at the start and exclusive at the end. - `from` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `to` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC. - `totals` BillingTotals, required — Totals contains the summaries of all calculations for a billing resource. - `amount` string, required — Numeric represents an arbitrary precision number. - `taxes_total` string, required — Numeric represents an arbitrary precision number. - `taxes_inclusive_total` string, required — Numeric represents an arbitrary precision number. - `taxes_exclusive_total` string, required — Numeric represents an arbitrary precision number. - `charges_total` string, required — Numeric represents an arbitrary precision number. - `discounts_total` string, required — Numeric represents an arbitrary precision number. - `credits_total` string, required — Numeric represents an arbitrary precision number. - `total` string, required — Numeric represents an arbitrary precision number. - `category` 'regular' | 'commitment', required — Cost category of a detailed invoice line item. - `discounts` BillingInvoiceLineDiscounts — Discounts applied to an invoice line item. - `amount` BillingInvoiceLineAmountDiscount[] — Monetary amount discounts (e.g. from maximum spend commitments). - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `reason` 'maximum_spend' | 'ratecard_percentage' | 'ratecard_usage', required — The reason a discount was applied to an invoice line. - `description` string — Optional human-readable description of the discount. - `external_references` BillingInvoiceLineExternalReferences — External identifiers for an invoice line item assigned by third-party systems. - … - `amount` string, required — Numeric represents an arbitrary precision number. - `usage` BillingInvoiceLineUsageDiscount[] — Usage quantity discounts (e.g. free tier usage allowances). - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `reason` 'maximum_spend' | 'ratecard_percentage' | 'ratecard_usage', required — The reason a discount was applied to an invoice line. - `description` string — Optional human-readable description of the discount. - `external_references` BillingInvoiceLineExternalReferences — External identifiers for an invoice line item assigned by third-party systems. - … - `quantity` string, required — Numeric represents an arbitrary precision number. - `credits_applied` BillingInvoiceLineCreditsApplied[] — Credit applied to this detailed line. - `amount` string, required — Numeric represents an arbitrary precision number. - `description` string — Optional human-readable description of the credit allocation. - `external_references` BillingInvoiceLineExternalReferences — External identifiers for an invoice line item assigned by third-party systems. - `invoicing_id` string — The ID assigned by the external invoicing app. - `quantity` string, required — Numeric represents an arbitrary precision number. - `unit_price` string, required — Numeric represents an arbitrary precision number. - `usage_quantity_detail` BillingInvoiceUsageQuantityDetail — Usage quantity details on an invoice line item when UnitConfig is in effect. Provides the full audit trail from raw meter output to the invoiced amount. - `raw_quantity` string, required — Numeric represents an arbitrary precision number. - `invoiced_quantity` string, required — Numeric represents an arbitrary precision number. - `display_unit` string — The display unit label (e.g., "GB", "hours", "M tokens"). - `charge` BillingChargeReference — Reference to a charge associated with an invoice line. - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier). - `meta` PaginatedMeta, required — returns the pagination information - `page` PageMeta, required — Contains pagination query parameters and the total number of objects returned. - `number` number, required - `size` number, required - `total` number, required ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden --- [API](https://skmtc.net/openmeterio/apis/openmeter-and-konnect-metering-billing-api.md) · [All operations](https://skmtc.net/openmeterio/apis/openmeter-and-konnect-metering-billing-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openmeterio/openmeter-and-konnect-metering-billing-api/versions/9bca44e2d61d/schema)