v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-03101355448.4 KB
OpenMeter Billing Settings

Get a billing invoice

Get a billing invoice by ID.

Returns the full invoice resource including line items, status details, totals, and workflow configuration snapshot.

get/openmeter/billing/invoices/{invoiceId}

Path parameters

invoiceIdstring required

ULID (Universally Unique Lexicographically Sortable Identifier).

Example:01G65Z755AFWAKHE12NY0CQ9FH

Response

Invoice response.

idstring required

ULID (Universally Unique Lexicographically Sortable Identifier).

descriptionstring

Optional description of the resource.

Maximum 1024 characters.

labelsLabels

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_atstring date-time required

RFC3339 formatted date-time string in UTC.

updated_atstring date-time required

RFC3339 formatted date-time string in UTC.

deleted_atstring date-time

RFC3339 formatted date-time string in UTC.

numberstring 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)
currencystring required

Three-letter ISO4217 currency code. Custom three-letter currency codes are also supported for convenience.

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.

issued_atstring date-time

RFC3339 formatted date-time string in UTC.

draft_untilstring date-time

RFC3339 formatted date-time string in UTC.

quantity_snapshotted_atstring date-time

RFC3339 formatted date-time string in UTC.

collection_atstring date-time

RFC3339 formatted date-time string in UTC.

due_atstring date-time

RFC3339 formatted date-time string in UTC.

sent_to_customer_atstring date-time

RFC3339 formatted date-time string in UTC.